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About This Manual 



This document describes the CP-6 6Edit screen editor. 

This manual is intended to be a complete reference for the experienced user, 
and is intended for reference rather than tutorial use. The manual is 
organized as follows: 



SECTION 1, OVERVIEW OF 6EDIT, describes the conceptual model upon which 6Edit 
is based: the objects it manipulates and the operations it performs on those 
objects. No details of actual use are given in Section 1, however. 

SECTION 2, USING 6EDIT, presents the details of how to run 6Edit, the 
environment it requires, and how it appears to the user. 

SECTION 3, 6EDIT COMMANDS, presents all of the 6Edit commands, their options, 
and examples of their use. 

SECTION 4, STRING EXPRESSIONS, describes string expressions, how to form them, 
and how they are evaluated by 6Edit. 

SECTION 5, BLOCK EXPRESSIONS IN 6EDIT, describes block expressions, how to 
form them, and how they are evaluated by 6Edit. 

APPENDIX A, PREDEFINED NAMES, lists 6Edit*s predefined names and describes 
their values and uses. 

APPENDIX B, PREDEFINED STRING FUNCTIONS, describes the built-in functions 
supported by 6Edit in string expressions. 

APPENDIX C, CONTEXT FILES IN 6EDIT, describes the standard context file and 
its components, and presents examples of terminal-specific context files. 

APPENDIX D, CUSTOMIZING THE 6EDIT USER INTERFACE, discusses how to tailor the 
6Edit user interface to your individual needs. 

APPENDIX E, INPUT EDITING FUNCTIONS, Lists all input editing functions 
available to the 6Edit user. 

APPENDIX F, THE ASCII CHARACTER SET, lists the ASCII character set with 
decimal conversions. 
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Changes Since Last Release 

There have been several changes to this manual to answer STARs and to correct 
spelling, format, and the HELP facility. These changes have been marked with 
change bars. Significant content changes are: 

Overview 

o The new predefined string function $KEY (or <key>) is explained in 

'Function Key and Control Key Notation', Section 1. $KEY (or <key>) is 
provided to represent function key names in KEYIN commands or EQUALS 
commands. 

o The parsing of $CONTROL-f unctions in string expressions is now performed 
only when the value of the string is actually used. It is no longer done 
when simply assigning the string expression to an EQUALS variable. In 
previous versions, parsing was performed at both times. So, for example, 
if a terminal had a function key sending <ESCx%>, an EQUALS command might 
assign that string to a variable with the key's name, for later use in a 
KEYIN command. In previous versions, the EQUALS command would require 
four percents. In A03, it only needs two. See 'SCONTROL Identifier', 

r ^ » 4. ; 1 
OCU L I UI I I . 

Using 6Edit 

o 6BUILD and 6X are alternate command names to invoke 6Edit. 

o 6Edit chooses unused UC streams for command and editing windows. 

Normally, it will use UC10 for the command window and UC11 for the first 
editing window. Additional editing windows normally start at UC12. These 
points are discussed in 'Command Window' and 'Editing Window' in Section 2 
(per star 32148). 

o 'Editing Window' in Section 2 explains that it is now possible to enter a 
command in the command window and have the cursor remain there for another 
command, by terminating the command with <CNTL-C> instead of <CR>. 

o 'Multiple Editing Windows' has been added to Section 2. 

o 6Edit can now be used conveniently in batch or on-line modes, or with 
non-CRT terminals. 'Serial Editing* in Section 2 and the subheadings 
'Switching between Serial and Screen Editing' and 'Manipulating Data in 
Serial Editing Mode' have been added. 



X 
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6Edit Commands 

o The DELETE FILE form of the DELETE command has been added to Section 3 
(per STAR 23879). 

o DO or ! commands can now be used to call other processors from within 
6Edit (per STAR 23353). 

0 The EQUALS command syntax in Section 3 is changed. The IN phrase now 
permits identification of a specific editing window. 

o An example showing the $KEY predefined string function has been added to 
the description of the EQUALS command in Section 3 (per STAR 28846). 

o The IF and ELSE commands, which provide conditional execution of multiple 
commands in a single Line, have been added to Section 3. 

o The KEYIN command syntax in Section 3 is changed. The IN phrase now 
permits identification of a specific editing window. 

o The KEYIN command description in Section 3 has been expanded to explain 
and illustrate the use of the $KEY predefined string function in KEYIN 
commands (per STAR 28846). 

o A new command, SHOW, displays 6Edit name definitions and selected records 
(per STAR 26518); see Section 3. 

o A new command, WINDOW, has been added to Section 3 (per STAR 26429). 

String Expressions 

o The discussion of string expressions has been expanded. 
Block Expressions in 6Edit 

o The BY option is changed for cases in which a block expression also 

creates a new edit block: that key increment overrides the value in the 
$BY predefined name for the rest of the life of that edit block. See See 
the 'BY Option* example. Section 5. 

o It is now possible to create and manipulate consecutive files and keyed 
files with text keys instead of 3-byte binary edit keys, as explained in 
•FILE Block Operand', Section 5. 

o A new SCONTROL function, W, for wildcard pattern searching has been added 
to Section 5 (per STAR 32349). 
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o 



string block expressions can 
wildcard portions of pattern 
Section 5. 



now be constructed from the corresponding 
expressions. See 'STRING Block Operand', 



Predefined Names 

o The following new predefined names have been added to Appendix A: 

$BY, SCONTEXT, SDIRECTION, $END_MARK, SEXIST, SFILEORG, SFILERECORDS, 
SFILETYPE, SINITIALIZE, $KEY_GENERATION, SPOINT, SPROTECT, SREKEY, 
SSCREEN, SSCROLL, STEXTEDIT, $WI_BORDER, $WI_PERCENT, ANY, AO, BACKWARD, 
BIN10, BINHLF, BIN521, BO, DONT_PROTECT, EO, FORWARD, NEW, OLD, PROTECT, 
STRING (per STARs 36719, 30049, 26518). 

o $BY existed previously but was not documented. The default key increment 
for new records, $BY, is now set and displayed as an edit key. If $BY was 
used with previous versions of 6Edit, the values used will now have to be 
divided by 1000. 

o The description of the $MATCH_LIMIT predefined name in Appendix A has been 
modi f ied. 

Predefined String Functions 

o Three new predefined string functions have been added to Appendix B: 
SCMDVAR and $KEY (per STAR 28846), and SCNTL. 

o The SINPUT string function described in Appendix B now reads from the 

command window instead of M$UC. This change, the result of an improvement 
to the XSEVAL routines, allows a more convenient interface for a "string 
substitution" KEYIN or SYNONYM command. Any other new features and bug 
fixes in the XSEVAL host library package as of 3/1/90 are also available 
in A03 6Edit. 

Context Files in 6Edit 

o Sample context files — for DECTVlOO, PCTV7800 and PCTX364 — have been 
added to Appendix C. 

Customizing the 6Edit User Interface 

o A discussion of function key definitions on a personal computer, using the 
KEYIN command with the SKEY predefined string function, has been added to 
Appendix D. 
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Input Editing Functions 

o These functions have been added: <ESC> <CNTL-D>, <ESC> <E>, 
<ESC> <n> <H>, <ESC> <n> <M>. 

Additional Changes 

In addition to the changes specific to this manual, the following software 
changes and corrections have also been made to 6Edit: 

o String expressions may now include predefined names that start with a 
dollar sign (per 32020). For example, SHOW LOCATIONS $NOT_COPIED . 

o When REKEY (the synonym for COPY CURRENT OVER CURRENT) is used to rekey a 
file, the cursor now returns to the current position in the editing window 
(per STAR 25698). 

o SCONTROL functions with more than one parameter, such as %V(m,n) and 

%W(min,max), now work properly in pattern-matching strings. For example, 
PATTERN %V(75,80). (Per STAR 32349.) 

o Moving a string to the left within the same record now works properly (per 
STAR 37411/25800). 

o When you attempt to edit a file that someone else has open in PROTECT 

mode, 6Edit now lets you open the file, still keeping it in PROTECT mode. 
The message "File filename is busy; open for reading only" is displayed. 
(Per STAR 26824.) 

o Per star 31671, 6Edit now stays in serial mode long enough for context 
file changes to control the building of the command window. 



On-Line HELP Faci I ity 

The 6Edit processor supports an on-line HELP facility. 6Edit users can 
display syntax formats, parameter descriptions, and examples at the terminal. 

The 6Edit HELP facility includes information about the 6Edit processor and 
commands. 

For a list of HELP topics from the system command level (!) or from another 
processor, enter the following at the terminal: 

HELP (6EDIT) TOPICS 

From within the 6Edit processor, enter: 

HELP TOPICS 
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Notation Conventions 



Notation Conventions used in command specifications and examples are Listed 
below. 



Notation Descr ipt ion 



Brackets 

Brackets are used to enclose an optional element. For 
example: 

[movement] indicates that a value for movement may 
be entered. 

When enclosing keywords, brackets signify that all of the 
bracketed portion may be entered or omitted. For example: 

DI[SPLAY] indicates that the command DISPLAY 

can be entered as either the word 
DISPLAY, or simply as the first two 
characters, DI. 

Note: A slash (/) may replace brackets in a figure or list 
of commands. For example: 

AC/CEPT SEND means that the first two characters of the 
ACCEPT name may be entered. 

If more than one element is enclosed in brackets, the 
notation indicates an optional choice. Multiple 
elements in brackets are separated by an OR bar or 
listed on separate lines. For example. 
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Notat ion 


Descr ipt ion 




[ ALL 1 LdevList ] 




and 




[ ALL ] 
[ LdevList ] 




have identicaL meaning: either ALL or a List of LogicaL 

device names is permitted. 


OR Bar 


The OR bar separates eLements encLosed in braces or 
brackets from which one must or may be chosen. For 
exampLe: 

{ENDIXIT} indicates that either END or XIT may 
be entered. 


Braces 


Braces around words separated by 1 (OR bars) indicate a 
required choice. For exampLe: 

{E[ND3IXI[T3IQU[IT3} means either END, XIT, or QUIT 

must be seLected. 


Lowercase 


Lowercase Letters identify an eLement that must be repLaced 
by a user-seLected vaLue. For exampLe: 

DE[LETE] BL[OCK] bLock_expression indicates the user 

suppLies a vaLue for 
b Lock_express i on . 
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Notation Description 



Careted Letters 

Letters inside carats (<>) identify physical keys on the 
terminal. Carats are not typed. The indicated keys are 
pressed. For example: 

<ESC> indicates touch the Escape key. 
Another example: 

<CNTL-T> means press and hold down the Control key while 
pressing the "T" key. 



Horizontal Ellipsis 

Horizontal ellipsis indicates that a previous bracketed 
element may be repeated or that elements have been omitted. 
For example: 

movement [[movement] ] indicates that one or more move- 

ment expressions may be entered. 
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Section 1 

Overview of 6Edit 



This section describes the major concepts behind the operation of the CP-6 
6Edit file editor. Actual procedures are covered Later in the manual. 



What is 6Edit? 

6Edit is a screen-oriented file editor. It inserts, deletes, and replaces 
data in a file. Although 6Edit accesses the file by reading and writing 
records, when using 6Edit you do not have to give instructions in terms of 
records . 

You normaLLy interact with 6Edit using "fuLL-screen editing," wherein 6Edit 
displays a portion of the file on the screen and you can update it directly by 
simply moving the cursor to the desired data on the screen, and typing in new 
data. 

When full-screen editing, you press keys on your terminal. Some of these keys 
cause 6Edit to perform actions, and some of the keys simply insert data into 
the file being edited. As you move the cursor, 6Edit automatically scrolls 
the file data up or down, using the terminal screen as a movable "window" on 
the data in the file. 

6Edit allows you, the user, to edit data in a variety of ways. For example: 

o Interactive editing, using the editing window. Single keystrokes on your 
terminal keyboard allow you to perform many common editing functions, such 
as ad hoc or repeated changes (e.g., change all x*s to y*s). 

0 Interactive editing, using the command window. Verbal commands typed in 
6Edit's command window enable more complex changes and additions, often 
involving data at arbitrary locations throughout the file. 

o Customization. The ability to change commands with user-defined synonyms, 
to alter key function definitions, and to customize the 6Edit context file 
for individual editing needs, makes 6Edit a highly versatile editing 
processor . 



CE70-02 



Overview of 6Edit 



What is 6Edit? 



1-1 



Most of the editing that occurs in 6Edit consists of selecting the data to be 
changed, and actually changing the data. 6Edit offers flexibility in both of 
these steps. Users can perform them: 

o Interactively, for ad hoc editing. 

0 Semi-automat ical ly, visually selecting information, then either skipping 
or changing the selection. 

o Automatically, using any combination of commands, which can be 
automatically repeated throughout the file. 



Files, Record Keys, and Records 

6Edit is used to edit disk files only. It can only access edit-keyed, 
string-keyed, consecutive, and unit record (UR) files. Edit-keyed files are 
CP-6 keyed files with 3-byte binary keys. Each record has a record key 
associated with it. The record keys are numbers between 0 and 99999.999, 
inclusive, with at most three digits to the right of the decimal point. 

File Pointer 

6Edit keeps track of a "file pointer" which "points" to a Location in a file. 
You can move the file pointer in three ways: 

o When full-screen editing, the cursor is effectively the file pointer. 
When you move the cursor (with, for example, the backspace key on the 
terminal), you are moving 6Edit's file pointer. 

o You can use the terminal's function keys to move the file pointer, by 
moving forward or backward in a file in units of characters, words, 
records, matches of a pattern string, etc. You must first tell 6Edit what 
the terminal's function keys mean, usually in a "context file." (See 
Appendix C, Context Files in 6Edit.) 

o You can enter commands to move the file pointer in the same way as the 
terminal function keys. (Actually, the terminal function keys simply 
generate commands; anything you can do with commands, you can make your 
terminal function keys do). You can also enter commands to move the file 
pointer to a specific file, or a record within a file, by typing the 
specific file name and/or record key in a command. 
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Blocks 

The 6Edit editing commands work with "blocks" of data. A block can be an 
entire file, or any portion of a file. As shown in Figures 1-1 through 1-4, a 



block is usually 
file. 


a string of characters taken from one or several records in a 


A block can be 
the end of the 


a portion of one record, excluding the record boundary at 
record. 


Example: 


The elevator doors in the lobby 




of thelSecond National BanklBuild- 




ing downtown were open Late Wed- 
nesday afternoon, but the elevator 
car was not there. Tom Hall, 42, 



Figure 1-1. Example of a Block 



A block can be all 
boundary. 


or part of a record, including the end-of-record 




Example: 


The elevator doors in the lobby 






of thelSecond National Bank Build- 1 






ing downtown were open late Wed- 
nesday afternoon, but the elevator 
car was not there. Tom Hall, 42, 






Figure 1-2. Example of a Block 
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B locks 



A block 


can be a set of records, with portions of the first and Last 


records 


(excluding the final end-of-record boundary). 


Example: 






The elevator doors in the lobby 




of thelSecond National Bank Build- 1 




1 

1 ing downtown were open late Wed- 1 




1 

1 nesday afternoon, 1 but the elevator 




car was not there. Tom Hall, 42, 


Figure 1-3. Example of a Block 



A block can be a set of records, with all or part of the first record and 
all of the last record, including the final end-of-record boundary. 



Example: 

The elevator doors in the lobby 



of thelSecond National Bank Build- I 
I 

I ing downtown were open late Wed- i 

I nesday afternoon, but the elevator I 



car was not there. Tom Hall, 42, 



Figure 1-4. Example of a Block 
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Specifying a Block 

You specify a block of data to edit by "selecting" the block. There are two 
ways to select a block: 

o When full-screen editing, you can direct the cursor to the beginning and 
the end of the block, moving it with the arrow keys or the function keys 
on the terminal. Moving the cursor is equivalent to moving the file 
pointer . 

o You can enter commands which direct the file pointer to the beginning and 
the end of the block to be selected. 



What You Can Do With a Block 

Once a block is selected, you can enter an editing command (or use a function 
key on your terminal) to manipulate the block of data. The things you can do 
with a block of data include: 

o Delete the selected block of data. 

o Copy the block of data to another location, either in the same file or a 
different file. 

o Move the block of data to another Location (same as copying the block, 
except that after copying it, it is deleted from its original location) 
either in the same file or a different file. 

o Insert previously selected data after the selected block. 

o Replace the selected block with another block of data (which you 
previously selected). 

o Give a name to the location of the selected block. Thereafter, using that 
name in a 6Edit command tells 6Edit to use the current data at that 
locat ion. 

o Edit the selected block. (See "Edit Block" below.) 

There are two special blocks used in 6Edit: the edit block and the 
selected block. 
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Edit Block 

The impLicit subject of all editing operations is the "edit block." The edit 
block is any set of records in any file. It can comprise one record or an 
entire file. Usually the edit block is all or a large portion of a file. 

You can edit less than an entire file, simply by telling 6Edit which portion 
of the file, or block, you want to edit. This is useful when you want to 
limit editing operations to one portion of the file. 

You can set the edit block explicitly with the EDIT command; you can refer to 
it explicitly using the "CURRENT" predefined name. 

The default for all editing commands is to edit a block which is located 
entirely inside the edit block. You can override this limitation, and specify 
a block anywhere in any file. (See Section 5, Block Expressions in 6Edit.) 

When you specify a file, or some other block operand which is Located outside 
the current edit block, 6Edit automatically changes the edit block to the 
specified file. This is called an "implicit EDIT" because it is as though 
6Edit automatically inserted an EDIT command in front of the command you 
entered. An implicit EDIT can occur during the following commands: 

AFTER 

DELETE 

DISPLAY 

LOCATION 

OVER 

For example, assume you have typed the following command: 

EDIT FILE ACCTS_PAYABLE 
The edit block is now all of file "ACCTS_PAYABLE". If you type the command: 

DISPLAY 23 

it displays record 23 from file ACCTS_PAYABLE. Your search is limited to the 
material within the existing edit block only; 6Edit does not search for record 
23 before the first record, or beyond the last record of the current edit 
block. 
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Now, you type this command: 



DISPLAY FILE INVENTORY 23 

Because you expLicitLy specified a file, it becomes the new edit block; the 
command displays record 23 from file "INVENTORY", and the new edit block is 
all of file INVENTORY. 

Note that the following two commands have the same effect on the edit block: 

EDIT FILE ACCTS_PAYABLE 
DISPLAY FILE ACCTS_PAYABLE 

Contrast with this the very different effects of the following two commands on 
the edit block: 

EDIT FILE ACCTS_PAYABLE 23 
DISPLAY FILE ACCTS_PAYABLE 23 

The EDIT command in this example sets the edit block to just record 23 of file 
ACCTS_PAYABLE; the DISPLAY command in the example sets the edit block to all 
of the ACCTS_PAYABLE file, then displays record 23. 



Edit Block Stack 

When you change to a new edit block, the previous edit block is not forgotten. 
6Edit maintains an "edit block stack", which holds the specifications of 
previous edit blocks. 

The edit block stack has a pointer, which refers to the current edit block 
specification (the "CURRENT" predefined name). When the edit block changes, 
either explicitly (EDIT command) or implicitly, 6Edit adds an entry to the 
edit block stack, and stores the specification of the new edit block in that 
entry. 

You can easily refer to the block specification in the previous entry in the 
edit block stack by using the PREVIOUS block operand in a block expression. 
The PREVIOUS block operand always changes the edit block, but instead of 
appending the new edit block specification to the end of the edit block stack, 
6Edit simply moves the edit block stack's pointer backward one entry. The new 
edit block is the previous edit block specification from the edit block stack. 
Once you have used PREVIOUS, you can similarly use the NEXT block operand to 
advance the edit block stack's pointer. The following examples illustrate 
responses generated by the edit block stack. 
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tack 



Note that when you change to a new edit block, thus adding a new entry to the 
stack, any entries from the current entry to the end of the stack are removed 
from the stack. Thus, you may not EDIT NEXT after introducing a new entry 
into the stack, since there is no Longer a NEXT file in the stack. 



Table 1-1. 


Operations in the 


Edit Block 


Stack 


You type: 


Edit Block Stack: 




EDIT FILE ABC 


1 FILE ABC 1 
current 






EDIT FILE DEF 


1 FILE ABC 1 


FILE DEF 1 








current 




EDIT PREVIOUS 


1 FILE ABC 1 


FILE DEF 






current 






EDIT NEXT 


1 FILE ABC 1 


FILE DEF 1 








current 




EDIT FILE GHI 


1 P T 1 P ART 1 


P T 1 P hPP 
r 1 LP uCr 


FILE GHI 1 








current 


PhTT PRPViniK 


1 FILE ABC 1 


FILE DEF 1 


P T 1 P f^UT 1 

r J. LC oni 1 






current 




EDIT PREVIOUS 


1 FILE ABC 1 


FILE DEF 


FILE GHI 1 




current 
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Edit Block Stack 



Table 1-1, Operations in the Edit Block Stack (cont) 



EDIT FILE XYZ I FILE ABC I FILE XYZ I 



current 



Selected Block 

The "selected block" is the last block you specified, either by moving the 
file pointer (cursor) or by entering commands. You manipulate the selected 
block using the editing commands: it can be deleted, moved, replaced, etc. 

For example, if you move the cursor to the beginning of a sentence, type THRU 
in the command window, then move the cursor to the end of the sentence, you 
have designated the new selected block. If you then type DELETE THAT in the 
command window, 6Edit deletes the sentence from the file. 



Compound Blocks 

In complex editing situations, you can specify "compound blocks" in 6Edit 
commands. There are two types of compound blocks: repeated blocks and 
enclosed blocks. 

Repeated Blocks 

Sometimes you want an editing operation to be performed at several locations 
in a file. For example, you may want to replace all appearances of the word 
"horse" with the word "giraffe." Rather than find each location and perform 
the operation manually each time, 6Edit allows you to enter a command which 
specifies a "repeated block." 

Specification of a repeated block in a command causes the entire command to be 
repeated as many times as needed, each time at a different location in the 
file. A block expression tells 6Edit how to move the file pointer to find the 
location of each repetition of the operation. (See below.) 
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Enclosed Blocks 

"Enclosed blocks" are used in commands to Limit movement of the file pointer 
temporarily. For example, you can specify that a pattern search be limited to 
a single record. This single record is called the "enclosing block." 



Express ions 

6Edit commands involve two types of expressions: string expressions and block 
expressions. 



String Expressions 

A string expression specifies either a number or a string of characters, 
depending on the context in which it is used. A string expression can combine 
different types of strings into one string by concatenating them. Also, a 
string expression can combine strings and numbers with the usual logical, 
relational, and arithmetic operators, producing a string of chiaracters which 
represent Logical (true or false), or numeric results. 

The types of strings which can be used in string expressions are: 

o String constants: strings of characters enclosed in apostrophes ('), or 
decimal numbers (not enclosed in apostrophes). The strings or decimal 
numbers represent constants. Character data (including non-displayable 
characters) may be entered using ASCII characters, their decimal codes, or 
their ASCII names. (See SCONTROL-Value Function later in this section.) 

o EQUALS-names: names of variables which have been assigned string values 
with the EQUALS command. These may be names you create or predefined 
names. 6Edit uses the value of a name in place of the name when 
evaluating the string expression. 

0 Predefined string functions: functions analogous to IBEX system functions 
that yield values (such as the date, the current directory account, the 
absolute value of an expression), and functions such as $CNTL and $KEY 
that yield strings that identify control keys, function keys, and special 
keystroke sequences. 
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Block Expressions 

A block expression specifies a block of data in a file. ALL editing commands 
have a single block expression as a parameter. This expression specifies the 
block of data upon which the editing command is to operate (to delete the 
block, to copy the block, to replace the block, etc.) 

Block expressions can indicate whether the block resides in a specific file, 
or if it resides in the edit block (the block currently being edited). The 
boundaries of a block can be given in absolute terms, such as a specific 
location in a file, or in relative terms, such as forward or backward from the 
current file pointer location, or in a combination of these. 

The LOCATION command allows you to give a name to the location of a block. 
Later, you can use that name in a block expression to refer to the designated 
block. 

Block expressions can be enclosed and repeated. When a block expression 
specifies a repeated block, the entire editing operation of which the block 
expression is a parameter is repeated. 



Keywords and Abbreviations 

6Edit commands use a keyword-style notation. All keywords may be spelled out 
fully, or abbreviated. You can choose any editing function by simply using 
the alphabetic characters, the numerals, and seven special characters. The 
following figure summarizes the keywords and non-alphabetic characters used. 
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Keywords 





6BUILD 


* 


DONT 




MOVE 


* 


REPEAT 




6EDIT 




EDIT 




NEW 




RESET 




6X 




EDITING 


* 


NEXT 


* 


RESTORE 




ADJUST 




END 




NUMBER 


* 


SAVE 




AFTER 




EO 




OF 




SELECT 




ALL 




EQUALS 




OLD 


■k 


SESSION 




ANY 


** 


ERASE 




ON 


* 


SETUP 




AO 




EXIT 




OUTPUT 




SHOW 




BACKWARD 




FILE 




OVER 




SKIP 




BEGINNING 




FORWARD 




PATTERN 




STRING 




BLOCK 


* 


HELP 




PATTERNS 




SYNONYM 




BO 


* 


HERE 




PERCENT 




SYNONYMS 




BY 




IN 




POSITION 


* 


THAT 




COMMAND 




IS 




POSITIONS 




THROUGH 




COPY 


★ 


KEY 




PREVIOUS 




THRU 


* 


CURRENT 




KEYIN 




PRINT 


■k 


TIME 




DATE 




KEYINS 




PROTECT 




TO 




DELETE 




LINES 




QUIT 


** 


TOPICS 


*** 


DIRECTORY 
DISPLAY 




LOCATION 
LOCATIONS 




READ 

RECORD 

RECORDS 




WINDOW- 
WINDOWS 
XIT 



ALL of the above may be entered in upper or Lower case and may 
be abbreviated to exactLy the first two characters, except 
those preceded by one or more asterisks. 

★ - must be abbreviated to exactLy the first four characters. 
★* - abbreviation is not permitted. 

*** - may be abbreviated with three or more characters. 
Non-aLphabet ic Characters 
NumeraLs: 0 through 9 

SpeciaL Characters: '(),.;? 



Figure 1-5. Keywords and Reserved SpeciaL Characters 
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Command Lines and Continuation 



A "command Line" is one record from the "command stream." The command stream 
usually originates from the keyboard of your terminal. (With the READ 
command^ you can switch the command stream to any file. Command lines will 
then be read from that file. See Section 3, 6Edit Commands.) 

Command lines contain one or more commands. Multiple commands in one command 
line are separated by a semicolon (;). 

If the command you type is longer than one line, type a semicolon as the last 
character of each ongoing line (except the last line of the command). 

Example: 

CO ST 'This drawn-out Line renders the command lengthy' AFTER; 
FI XYZ 20.5 



Lexical Functions 

You can instruct 6Edit to perform certain Lexical functions during command 
entry. You can invoke these functions by using identifier characters, which 
are the values of two predefined names: SCONTROL and SCOMMENT. 

Initially, 6Edit uses the following default identifier characters for the 
SCONTROL and SCOMMENT functions: 

% invokes the SCONTROL function 
invokes the SCOMMENT function 

6Edit looks for the SCOMMENT identifier in command input and READ-file 
records, and for the SCONTROL identifier in quoted strings. It does not look 
for these identifiers (nor perform their functions) in records read from data 
f i Les. 

It is possible to use the SCONTROL or SCOMMENT identifier without invoking its 
Lexical function. This can be accomplished in two ways. One is to disable 
the name. To do this, you assign an empty string to the predefined name 
SCONTROL or SCOMMENT. Thereafter, 6Edit does not support the functions 
invoked by SCONTROL or SCOMMENT, and will not look for the identifier in 
command lines, READ-file records, or quoted strings. 

Or, when using the SCONTROL identifier, you can enter it twice (see 
SCONTROL-LiteraL Function, below.) 
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Lexical Functions 



The functions invoked by the SCONTROL and SCOMMENT identifiers are described 
beLow. 



$CONTROL Identifier 

The SCONTROL identifier is used to invoke several functions which are called 
"SCONTROL functions". Initially, the value of SCONTROL is the percent sign 
(%). 

The character following the SCONTROL identifier is called the 
"function identifier". 

Some of the SCONTROL functions require an operand to be included along with 
the function identifier. Normally, a SCONTROL function is specified as 
f ol lows: 

SCONTROL__ident i f ier f unct ion_ident if ier 
These characters are to be entered together; there is no space between them. 
Parameters: 

SCONTROL_ident i f ier represents one or two characters designating the 
current value of the SCONTROL predefined name. (See Lexical Functions, 
above. ) 

funct ion_ident if ier specifies the function 6Edit is to perform. 



For example, assume that the SCONTROL identifier is %: 

%% invokes the SCONTROL-Literal function 
%R invokes the SCONTROL-Record function 
%V invokes the SCONTROL-Value function 

Note: SCONTROL functions used in EQUALS commands are not interpreted when 
assigned, but only when the resulting variable is used in a different command. 

Certain SCONTROL functions require one or two operands along with the function 
identifier. Enclose both in parentheses following the function identifier: 

SCONTROL_identif ier function_ident if ier ([operand]) 
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For example: 

%V() invokes the $CONTROL-Va Lue function with no operands 

%V(23) invokes the $CONTROL-VaLue function with one operand: 23 
%V(23,255) invokes the $CONTROL-Va Lue function with two operands: 
23 and 255 

To change the identifier which invokes SCONTROL functions, you assign a 
different character value to the SCONTROL predefined name. The characters 
assigned to the SCONTROL name must reside in the following set: 

!"'#$%&* + -a:< 

= >/[\]"^'{l}-' 

However, the characters which represent the current value of the SCOMMENT 
predefined name (initially cannot be used in the value of the SCONTROL 
predefined name. 

The following paragraphs describe most of the SCONTROL functions available. 
See Section 5, Block Expressions in 6Edit, for descriptions of additional 
SCONTROL functions which may only be used in pattern strings. 



SCONTRDL-L i tera I Funct i on 

Function Identifier: the SCONTROL identifier itself. 

This SCONTROL function allows you to include the SCONTROL identifier itself in 
quoted strings. 6Edit recognizes two adjacent occurrences of the SCONTROL 
identifier as representing a single SCONTROL identifier; no other lexical 
function is performed. 

Example: 

COPY STRING '48%% are qualified* AFTER HERE 

inserts the string "48% are qualified" into the file. 
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SCDNTRDL-Record Function 



Function Identifier: R 

The SCONTROL-Record function represents an "end-of-record boundary." 

This function may be invoked in quoted strings. The SCONTROL-Record function 
is the only way to represent an end-of-record boundary in quoted strings. 

Example: 

COPY STRING 'The quick brown fox%Rjumped over the Lazy dog%R' AFTER 10 

inserts two records after record 10.0 in the file being edited. The first 
record contains "The quick brown fox"; the second record contains 
"jumped over the Lazy dog". 

COPY STRING 'whenever available ' AFTER 10 SELECT 'respond ' 

inserts two words into record 10.0 after the word "respond". Note the absence 
of any SCONTROL-Record function: the quoted string does not represent a 
record, but just a string of characters. This command creates no new records. 
Record 10.0 is simply lengthened. 

Figure 1-6, below, illustrates the quoted string before the SCONTROL-Record 
f unct ion. 



We would appreciate an itemized inventory sheet from your 
department. You can I respond I stock 
arrives from the Omaha branch. We will expect a complete 
List, signed and dated by the area manager, at that time. 



Figure 1-6. CONTROL-Record Function Before 



COPY STRING 'whenever available%R' AFTER 10 SELECT 'respond ' 

inserts two words into record 10.0 after the word "respond". Also, because 
the SCONTROL-Record function is included in the quoted string, a new record is 
inserted after record 10.0. 
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Figure 1-7, below, illustrates the quoted string after two SCONTROL-Record 
commands. 



CO ST 'whenever available ' AF 10 SE 'respond ' 

We would appreciate an itemized inventory sheet from your 
department. You can respond I whenever available I stock 
arrives from the Omaha branch. We will expect a complete 
List, signed and dated by the area manager, at that time. 

CO ST 'whenever available%R' AF 10 SE 'respond ' 

We would appreciate an itemized inventory sheet from your 

department. You can t respond whenever available I 
stock 

arrives from the Omaha branch. We will expect a complete 

list, signed and dated by the area manager, at that time. 

Figure 1-7. CONTROL-Record Function After 



SCuNTRuL-Va I ue Funct i on 
Function Identifier: V 
Parameters: 

value is a decimal number between 0 and 511, inclusive. 

The SCONTROL-Value function allows you to enter any 9-bit byte value in quoted 
str ings . 

This function requires an operand following the function identifier. 
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For example, assuming that SCONTROL is %, to enter a quoted string which 
contains a single byte with a value of 23, you would type: 

'%V(23)' 

Example: 

ESC EQ VoVCZ?)' 

defines a name, ESC, with the value of the escape character. The number 27 is 
the decimal ASCII code for the Escape character. 

KEYIN '%V(27)A' IS 'harbinger of glad tidings' 

redefines the terminal key sequence Escape A. Hereafter, whenever <ESC> <A> 
is typed at the terminal keyboard, it appears as the phrase "harbinger of glad 
tidings". 

$COMMENT Identifier 

The SCOMMENT identifier is used to denote commentary in command lines. The 
quotation mark (") is the initial SCOMMENT identifier. 

When the SCOMMENT identifier appears in a command line outside of a quoted 
string, 6Edit ignores the foL Lowing text, until the next appearance of the 
SCOMMENT identifier or the end of the command line. This allows you to append 
commentary to command lines by separating the commentary from the actual 
command(s) with the SCOMMENT identifier. 

Note that the SCOMMENT identifier is not recognized inside quoted literal 
str ings. 

Example: 



CASE EQ OFF "This is commentary 

is not concluded by a quotation mark, because the commentary occurs at the end 
of the command line. 

LOCATION CHAPTER_1 IS "Definition follows:" BO CURRENT THRU '.brp' 

differs from the former command line. Here, the commentary occurs in the 
middle of the command line, and is therefore enclosed by quotation marks. 
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To change the identifier which invokes SCOMMENT functions, you assign a 
different character value to the SCOMMENT predefined name. The characters 
assigned to the SCOMMENT name must reside in the following set: 

!"#S%&* + -a:< 

= > / [ \ ] ^ _ ' { I } ~ 

However, the characters which represent the current value of the SCONTROL 
predefined name (initially %) cannot be used in the value of the SCOMMENT 
predefined name. 



Function Key and Control Key Notation 

6Edit recognizes function keys, control keys, and ASCII control codes as 
string expressions. The key or code name must be enclosed in angle brackets 
("<", ">") or be the argument of the SKEY function, for example: 

KEYIN <F1> IS ... 
KEYIN <UPARROW> IS ... 
KEYIN <ENT> IS ... 
KEYIN <F1>I I 'A' IS ... 

Note that abbreviations accepted by IMP (such as "ENT" for "ENTER" above) will 
also be accepted by 6Edit. 

Also note the Last example above: function keys may be used as introducers 
for multi-key sequences. 

6Edit accepts the name of any key on the terminal keyboard inside the angle 

brackets. This includes not only the FEP/prof i le-def ined function keys, but 

also the ASCII control characters (plus the DEL character) as mnemonics: 



NUL 


ENQ 


LF 


SI 


DCA 


EM 


RS 


SOH 


ACK 


VT 


DLE 


NAK 


SUB 


US 


STX 


BEL 


FF 


DC1 


SYN 


ESC 


DEL 


ETX 


BS 


CR 


DC2 


ETB 


FS 




EOT 


HT 


SO 


DC3 


CAN 


GS 





Also, ASCII control keys can be included inside the angle brackets, using the 
identifier "CNTL": 

<CNTL-x> 

where "x" is any one of: H), A-Z, [, \, ], _ 

a-z, {, I, }, - 
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The ASCII mnemonics evaluate to the corresponding ASCII code (0 - 31 and 127). 
However, use of the function key elements in a numeric expression yields an 
error; use of the function key elements in an expression not used (eventually) 
by the KEYIN command yields unpredictable results. 

The angle bracket notation is intended to reinforce the notation used in the 
manuals when referring to keystrokes at the terminal keyboard. See CE70 and 
CE73, Notation Conventions. 

Additionally, the SCNTL predefined string function is permitted in string 
expressions: 

SCNTL 

SCNTL is much like the <CNTL-x> expression element; it is included as a 
computational form of <CNTL-x>: SCNTL takes a string argument possibly longer 
than one character, whereas the angle bracket notation is limited to a single 
character. SCNTL returns a string which contains the ASCII control-codes for 
the characters in the original string. 

Examples: 

KEYIN <ESC>II'A' IS <CNTL-C>1 I 'BA SK 20 RE'II<CR> 
KEYIN ESCII'A' IS <ETX>I I 'BA SK 20 RE' I ICR 

The above two examples are identical; the second assumes that the names "ESC" 
and "CR" have been defined by the user, probably in the context file as they 
are now. 

DOITTOIT EQ $INPUT( 'Type control char to define: ') 
KEYIN $CNTL(DOITTOIT) IS <ESC>I I* 5R' I ISCNTLC '[W ) 

Note that <CNTL-[> is Escape, so "SCNTLC ' [W )" is the sequence <ESC> <CNTL-W>. 



Names 

In 6Edit, you can create your own names for things. This makes it easier to 
remember specific details, such as the Location of data. Names also make it 
easier to refer to something repeatedly, such as an often-used sequence of 
keywords. 

Each name has a value associated with it; the value is the Location or object 
to which the name refers. 
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You create names with the assignment commands; these commands are also used to 
change the value of a name. The assignment commands are: 

EQUALS 
LOCATION 
SYNONYM 
KEYIN 

Some names are "predefined" by 6Edit; that is, whenever you run 6Edit the 
names have already been created. These names are used to communicate details 
between you and 6Edit. You can change the value of some of the predefined 
names; others may not be changed by you, their values are changed internally 
by 6Edit. 

Names are used in several ways in 6Edit: 

o The EQUALS command assigns a reasonably short value (up to 511 characters) 
to a name. The value is stored as a string of characters, which may 
represent numeric or character data, depending on how the name is later 
used. The name can be used in the expression component of a command; 
6Edit uses the name's value in place of the name when evaluating the 
expression. 

o The LOCATION command assigns to a name the boundaries of a block of data 
in a file. To later refer to that location in the file, include the name 
in an editing command; 6Edit treats the name as a reference to the block. 

o The SYNONYM command assigns a fragment of a 6Edit command line to a name. 
If 6Edit later sees the name in a command line, it replaces it with the 
fragment which is the name's value. 

o The KEYIN command redefines a key on your terminal. Here, the name being 
assigned is the actual character or sequence of characters generated by 
the terminal key, or an encoded representation of the name of the key. 
When a terminal key is redefined, the CP-6 system will cause it to 
generate any sequence of characters that you specify. When you type the 
key (or sequence of keys), the system will echo on your terminal the 
sequence of characters which represent the name's value. 
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Value Types 

When assigning a value to a name, you must be aware of the "type" of the 
value. The type of a value is determined by the assignment command you use to 
assign the value to a name. 

Each of the assignment commands assigns a different type to the name's new 
value. The types of values supported by 6Edit are: 

o EQUALS-value: a string of up to 511 characters. 

o LOCATION-value: a specific block of data in a specific file. 

o SYNONYM-value: a fragment of a 6Edit command-line. 

o KEYIN-value: an arbitrary sequence of characters as they would be typed 
at a terminal, including escape and other control characters which may 
invoke editing functions (such as backspace or carriage return). 

Beware of the required "type" of the predefined names. Each of the predefined 
names may only be assigned values of a specific type. Appendix A, 
Predefined Names, lists the predefined names along with the command which 
should be used to assign values to each of them. If you try to assign a value 
to a predefined name using the wrong command, 6Edit rejects the command. 



Substitution 

"Substitution" refers to the substitution of the value of a name for the name 
itself. Substitution may occur when you enter command lines and data to 
6Edit; substitution may also be performed on input from your terminal and from 
command files. 

In 6Edit, there are four methods of substitution. These correspond to the 
four types of values which a name may have. 
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The table below contrasts the different methods of substitution. 



Assignment Command 


Lexical ly 


Semantical Ly 


Evaluated 


Type 


name EQUALS string__exp 


checked 


checked 


now 


str ing 


LOCATION name IS bLk_exp 


checked 


checked 


now 


locat ion 


SYNONYM name IS fragment 


checked 


unchecked 


later 




KEYIN name IS string_exp 


unchecked 


unchecked 


later 





For the EQUALS and LOCATION commands, the expression for the value is 
evaluated when the assignment command is processed; the result of the 
evaluation is the value given to the name. However, for the SYNONYM and KEYIN 
commands, the value is saved as a sequence of characters. Later, when the 
name is used, 6Edit evaluates the saved sequence of characters. 

EQUALS-VaLues and LOCATION-Values 

The EQUALS and LOCATION commands operate similarly, with the exception of the 
type of the value they assign to a name. For the EQUALS command, the value is 
a character string (which may represent a number). For the LOCATION command, 
the value is the location of a block of data in a file. 

Example: 

START__POS EQUALS END_POS 

is legal. END__POS is evaluated now. 

ANSWER EQUALS 'ABC 

is illegal, and will be rejected. The string has unbalanced quotes. 
LOCATION CHAPTER_1 IS FILE MY__BOOK SKIP 3 

is illegal, and will be rejected. The block_expression must be complete. It 
is evaluated now. The SKIP 3 option must be followed by a block operand. 
(See Section 5, Block Expressions in 6Edit, for details.) 
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When processing a SYNONYM command, the fragment which is the value is 
lexically checked (parsed), and any comments are removed. However, no further 
processing of the fragment is performed. The value assigned to the name is 
simply the decommented text of this fragmented command Line. 

A name whose value is a SYNONYM-va lue can be used anywhere in any 6Edit 
command line, including the SYNONYM-va lue of a SYNONYM command. 6Edit 
substitutes the fragment which is its value for the name. 6Edit semantically 
checks the fragment only when the name is used, for example, when a fragment 
is substituted into a command line. 

Example: 

SYNONYM START_POS IS END_POS 

is legal. END_POS will not be evaluated until START_POS is used. 
SYNONYM ANSWER IS 'ABC 

is illegal, and will be rejected. The string has unbalanced quotes. 

SYNONYM CHAPTER_1 IS FILE MY_BOOK SKIP 3 

is legal. The block_expression will not be evaluated until CHAPTER_1 is used 
in a command line. 

KEYIN-Values 

Normally, values in assignment commands must at least be lexically correct 
(parsable into legal fragments). A lexically unchecked value (enclosed in 
string delimiters) is allowed in the KEYIN command only. When redefining a 
terminal key, it is useful to be able to generate any sequence of characters. 
A KEYIN-value, then, is any arbitrary sequence of characters; it may include 
displayable and non-displayable characters, control-characters, and 
input-editing functions recognized by the CP-6 system. 

KEYIN-values are only useful when running 6Edit on-line. A name whose value 
is a KEYIN-value is recognized by the CP-6 system whenever you type the 
keystrokes which form the name. When the keystrokes are received by the 
system, the sequence of characters that represents the name's value is 
substituted for the keystrokes that comprise the name. 

Note that 6Edit substitutes KEYIN-values for their names in any input from the 
terminal (command lines as well as data records). KEYIN-values are not 
substituted, however, in input from command files (initiated with the READ 
command) . 
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Example: 

KEYIN 'J^VCIO)' IS '"ABC 

is Legal. When you type linefeed (ASCII 10)^ the characters 
'ABC 

appear on the terminal. 
Copy and Hove Operations 

In 6Edit, you can copy or move a block of data from one location to another. 
This is done in two steps: 

1. First, you specify the block you want to copy or move; this is called the 
"source block." The COPY and MOVE commands specify the source block for 
the operation. 

2. Then, you specify the "destination" for the copy /move. Use the AFTER 
command to insert the source block at a location in a file. Or, use the 
OVER command to replace a destination block with the source block. 

The COPY and MOVE commands do not make any changes to the file; they just 
specify the source block for the copy/move operation. Only when you enter an 
AFTER or OVER command is the copy /move operation performed. 

Both the source and destination blocks can be any sequence of characters, 
records, or parts of records. 6Edit uses the same commands to copy/move one 
characters, an entire file, a sentence, or a few words. 

When copying a block of data, 6Edit maintains any "record boundaries" in the 
block; that is, characters which were together in one record in the source 
block remain together in one record after the operation, at the destination 
location. 



Record Key Generation 

In a copy/move operation, the source block may or may not include record 
boundaries. If the source block does include a record boundary, 6Edit must 
insert new records into the file at the destination location. 
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Unkeyed Files 

Records may not be inserted into consecutive files or unit record (UR) files 
except at the end of the file. 6Edit does not need to generate any record 
keys in this case. 

Edit-Keyed Files 

If the destination file uses edit keys, new keys must be generated for any 
inserted records. 6Edit adds the value of the BY option to the key of the 
destination record to compute the new record keys. The BY option may be 
specified in the block__express ion of the AFTER or OVER commands. If no BY 
option is given, 6Edit uses the value of the predefined name $BY. 

If a key created with this increment conflicts with a key already in the file, 
6Edit divides the increment by 10. This division is repeated until a new key, 
one which does not conflict with any already in the file, is created. 

If no such key can be created, 6Edit tries to move some records nearby to make 
room for the insertion, governed by the SREKEY predefined name. If SREKEY is 
zero, 6Edit discontinues the copy/move operation, informs you of the problem, 
and no further processing of the source block, such as deletion for a MOVE 
command, occurs. 

String-Keyed Files 

Records may only be inserted into a string-keyed file individually and by 
explicitly specifying the key to be used. 



Rekeying a Keyed File 

When 6Edit tries to create a new record key and is not able to and SREKEY is 
zero, it will abort the operation. If the file is an edit-keyed file, you can 
rekey the file and resume the operation using the following command: 

COPY CURRENT OVER CURRENT 

The Synonym REKEY, defined in the standard context files, can be used instead: 

REKEY 

This command can only be used when you are editing the entire file. 

Optionally, you can add the BY option to control the record keys used when 
rekeying the file as follows: 

COPY CURRENT OVER CURRENT BY 5 
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or 

REKEY BY 5 

uses 5.0 as the first record key in the rekeyed file. Each successive record 
wiU have a key which is Larger by five more increments than the previous key 
(i.e., the rekeyed file's keys wiLL be 5.0, 10.0, 15.0, 20.0, ...). 
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Section 2 
Using 6Edit 



This section describes the environment which 6Edit requires for operation, the 
invocation of the 6Edit processor, and the user interface. 



DCBs 

6Edit uses eleven DCBs. Before starting 6Edit, you can set some of the DCBs 
to other files or devices, using the IBEX SET command. The following list 
describes each DCB. 

M$SI 

can be set to a file containing 6Edit commands. 6Edit executes these commands 
after it reads the context file. 

M$6E 

can be set to the window which 6Edit is to use as the terminal screen. If it 
is not set, 6Edit uses all but the top line of UC01. 

MSFILE 

can be set to correspond to the file to be initially edited. You may also 
designate the initial file on the IBEX command line. 

M$DO 

receives error messages from 6Edit in non-interactive mode (BATCH or XEQ), or 
if set to a file. 

M$EI, M$E9, W$6E00, M$6E01, M$EW 

are reset (or "scrubbed") by 6Edit. You should not set them. 
M$ME 

receives information messages in non-interactive mode, and accepts command 
input in interactive but not full-screen mode (e.g., SSCREEN EQ 0). 
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M$LO 



is used in non- interact ive mode to echo commands if echoing is enabled (in 

IBEX), to display error messages, and to display information from the SHOW 

command. It is normally assigned to the command window, but may be redirected 
via the OUTPUT command. 



Context File 

When 6Edit is invoked, it first looks for a "context file" containing 6Edit 
commands. These commands set up the environment in which to do your editing. 

The file 6Edit looks for is called: 

:6EDIT_C0NTEXT_prof ilename 

where prof ilename is the name of your current terminal profile. If 6Edit 
cannot locate that name, it looks for: 

:6EDIT_C0NTEXT 

6Edit looks for these two file names first in your !DIR account, then in your 
Logon account, and finally in .:LIBRARY. 

6Edit's standard context file is :6EDIT_C0NTEXT. : LIBRARY. It supplies common 
assignments. This context file is terminal independent, because it uses 
Escape sequences and control-keys for all functions, and does not assume that 
your terminal has any function keys. There are other context files, designed 
for use with specific terminal profiles, in the .:LIBRARY account. 

As an alternative to these context files, you can build your own personal 
context file in your logon account. Because 6Edit reads the context file 
every time it is invoked, the context file should contain only those commands 
which you want executed every time you run 6Edit. This eliminates the need to 
retype them each time you invoke 6Edit. 

For example, you may want to include KEYIN commands in the context file to 
redefine the keys of your terminal. This is particularly useful if your 
terminal has function keys or unlabeled keys: you can define them to generate 
any sequence of characters, commands and/or input editing functions you wish. 
(See Section 3, 6Edit Commands, for a discussion of the KEYIN command.) 

You may also want to include SYNONYM commands in the context file. These 
define words or special characters to be synonyms for 6Edit keywords or 
phrases. (See Section 3, 6Edit Commands, for a discussion of the SYNONYM 
command. ) 
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Before you alter the contents of a context file, you should copy the standard 
context file into your account, and then change it. (Appendix C, Context 
Files in 6Edit, provides examples of 6Edit context files. Appendix D, 
Customizing the 6Edit User Interface, provides some guidelines to consider 
before designing a context file.) 



Searching for a Context File 

You can override the fixed name and directory search list which 6Edit uses to 
find a context file at start-up by using the IBEX LET command: 



!LET SETUP 6EDIT='fid' 



where fid can be any of the following: 



o Only a file name (no account, packset name, or password can be given). 
6Edit looks for just this file name in your !DIR account, then in your 
logon account, and finally in .:LIBRARY. 

o Only an account. 6Edit looks for the :6EDIT_C0NTEXT_prof i Lename file 
name, then for :6EDIT_C0NTEXT. However, it looks for these file names 
only in the account specified in fid. 

o Both a file name (which may include an optional packset name and password) 
and an account. 6Edit looks for just that file name in only the specified 
account. 

In the file name portion of the fid, you can use two special character 
str ings: 

>U - If this appears in the fid, it is replaced with the current 
user's name. 



>P - If this appears in the fid, it is replaced with the current 
terminal profile name. (If 6Edit is running in batch mode, 
>P is simply removed from the fid.) 

In both of these substitutions, an underscore (_) separates the substituted 
text from the rest of the fid. 

The following table gives examples of different values of SETUP_6EDIT and 
files 6Edit searches for. The current terminal profile used is VIP7801, and 
the user name is EMC2EINSTEIN. 
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Table 2-1. 6Edit Setup Files 


If SETUP 6EDIT is set to: 


then 6Edit looks for one of these files: 


:6EDIT_C0NTEXT>P 
WP>U>P 

6E_D0CUM>P.EINSACCT 
.EINSACCT 


:6EDIT CONTEXT. dir_account 

:6EDIT_C0NTEXT_VIP7801.dir_account 

:6EDIT_C0NTEXT. logon_account 

:6EDIT_C0NTEXT_VIP7801. logon_account 

:6EDIT_C0NTEXT.: LIBRARY 

: 6EDIT_C0NTEXT_VIP7801 . : LIBRARY 

WP_EMC2EINSTEIN.dir_account 

Wr CrlL ^QllMo 1 t ilM__V Ir f OU 1 .ul 1 dC COUn L 

WP_EMC2EINSTEIN. logon_account 
WP_EMC2EINSTEIN_VIP7801 . logon_account 
WP EMC2EINSTEIN.:LIBRARY 
WP_EMC2EINSTEIN_VIP7801 . : LIBRARY 

6E DOCUM. EINSACCT 
6E_D0CUM_VIP7801. EINSACCT 

:6EDIT_C0NTEXT. EINSACCT 
:6EDIT_C0NTEXT_VIP7801 .EINSACCT 



Starting 6Edit 

6Edit is entered from IBEX using the following command: 

!{6E[DIT]I6B[UILD]I6X} [fid] [(command list[)]] 
Parameters: 

fid identifies the initial file to be edited. 

command list specifies one or more initial commands. (See Section 3^. 6Edit 
Commands, for a command summary.) If a READ command is included in the 
command list, the trailing right parenthesis must be omitted. 
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Descr ipt ion: 



Note that the context file is read and executed before the IBEX command Line's 
command List is executed. This means, for exampLe, that synonyms defined in 
the context fiLe can be used in the command List. 

If a command List incLudes more than one command, the commands must be 
separated by semicoLons (;). 

When started, 6Edit dispLays a greeting: 

6Edit A03 Here. 

There is a deLay whiLe 6Edit reads the context fiLe appropriate for this 
session, based on your terminaL profiLe name and your current fiLe management 
(DIR) account. If fid is incLuded in the IBEX command Line, 6Edit dispLays it 
after cLearing the terminaL screen. If fid is omitted from the IBEX command 
Line, 6Edit prompts for a command. When waiting for a command to be entered, 
6Edit dispLays an asterisk (*) on the terminaL screen. 

ExampLes: 

!6EDIT DAILY_JOB 

or 

I6EDIT (FILE DAILY_JOB 

or 

!6E DAILY JOB 

starts 6Edit, editing the fiLe DAILY_JOB, the beginning of which is dispLayed 
in the editing window. 

16EDIT (NEW FILE WEEKLY_JOB.MYACCT 

or 

16BUILD WEEKLY_JOB.MYACCT 

starts 6Edit, creating a new fiLe named "WEEKLY_JOB" in account "MYACCT". The 
editing window is initiaLLy empty, ready for you to enter text into the fiLe. 

!6EDIT (PROTECT FILE YEAR_END_JOB) 

or 

!6X YEAR END JOB 
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starts 6Edit, editing the file YEAR__END_JOB. This tile is "protected", that 
is, you cannot make changes to the file, you can only view the file in the 
editing window. 

!6EDIT DB_UPDATES (28.4) 

starts 6Edit, editing file DB_UPDATES. The command list specifies that 6Edit 
is to put the cursor on the record with key 28.4. Instead of displaying the 
beginning of the file, 6Edit displays the records near record 28.4 in the 
editing window. 



Faster 6Edit Invocation 

6Edit processes a file created by 6Edit's SAVE command much faster than a 
normal textual READ-file. To start 6Edit faster, you should first SAVE an 
encoded version of the context file you wish to use. 

For example, if you plan to use the standard context file, run 6Edit and use 
the SAVE command as follows: 

!6EDIT 

* 6Edit A03 Here. 

* Reading :6EDIT_C0NTEXT.someaceount . 
★SAVE SETUP TO : 6EDIT_C0NTEXT .youraccount 

Now, the next time you start 6Edit, it will use the encoded version of the 
context file. 



Screen Appearance 

6Edit typically divides the screen as illustrated in Figure 2-1 and explained 
in the following paragraphs. Additional capabilities affecting screen 
appearance — multiple editing windows and serial editing — are described 
later in this section. 

6Edit normally divides the terminal screen into three "windows": the "IBEX 
window" in the top line of the screen, the "command window" in the upper half 
of the screen, and the "editing window" in the lower half of the screen. A 
straight line across the screen forms a "border" which separates the IBEX and 
command windows from the editing window. 
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IBEX window 
* command window 



editing window 



Figure 2-1. The 6Edit Screen 



You can edit the characters appearing in any window using the input editing 
functions. Input editing functions (entered at the keyboard) are key 
sequences beginning with the control (<CNTL>) or escape (<ESC>) key. Some 
input editing functions are introduced Later in this section. (See Appendix E 
for a List of aLL input editing functions supported by 6Edit.) 



IBEX UlindouJ 

The IBEX window is represented by one Line above the command window at the top 
of your terminaL screen. The IBEX window processes certain gLobaL commands 
when you are in 6Edit. It is an option. 

To remove the IBEX window from your screen, enter the foL Lowing command at the 
IBEX prompt before starting 6Edit: 

!SET M$6E UC01 

or 

lADJUST M$6E UC01 
before any editing command. 

If you remove the IBEX window, you have an extra Line for editing. Also, 
since what you've realLy done is to combine the IBEX window and the command 
window, any commands that need to use the IBEX window will probabLy have more 
Lines available. The disadvantage of combining the IBEX and command windows 
is that since keyins and IMPs are realLy the same thing, any keyins that you 
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define in 6Edit for the command window wiLL remain in the IBEX window after 
you exit 6Edit. You wiU have to restore any needed IMPs either manually or 
via the SRESTORE predefined name. This problem can be eliminated if you do 
not need to use keyins in the command window by specifying "IN EDITING" for 
all your keyin definitions. 

If you do not remove the IBEX window, any IMPs or keyins used in your context 
file during that session are removed when you exit 6Edit. 6Edit restores your 
terminal environment to its former status. 

By not removing the IBEX window, you give up screen space. Since the window 
uses a Line at the top of your screen, you are short one editing window Line 
at the bottom. 

For example, if you normally define <ESC> <1> to issue a CHECK command, and 
you redefine Escape 1 during a 6Edit session to generate a COPY THAT command, 
then when you leave 6Edit: 

o If you had an IBEX window during the 6Edit session (the default), <ESC> 
<1> reverts back to generating the CHECK command. 

o If you did not have an IBEX window during the 6Edit session (i.e., you 

iSET M$6E UC01 before starting 6Edit), <ESC> <1> still generates the COPY 
THAT command. (See the SRESTORE name in Appendix A, Predefined Names.) 



Command lU i ndou] 

Lines at the top of your screen (above the border line) comprise the command 
window. The number of lines in this window changes depending on the window's 
usage. When the command window displays messages, it grows larger; when you 
type commands in this window, it remains small. 

When the cursor is in the command window, you can type 6Edit commands. (See 
Section 3, 6Edit Commands, for details.) 

You can control the minimum and maximum size of the command window by 
assigning values to the predefined names "$MIN__COMMAND" and "$MAX_COMMAND". 
(See Appendix A, Predefined Names.) 

The stream name for the 6Edit command window is the Lowest unused UC stream 
greater than UC09 (usually UC10). 
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Ed i t i ng LU i ndoiu 



The editing window occupies the Lower portion of your terminal screen (below 
the border line). It displays records from the file being edited. 

Besides using the input editing functions, you can edit the data in the 
editing window using the editing commands. (See Section 3, 6Edit Commands.) 

To move the cursor from the editing window to the command window, type 
<CNTL-C> (hold down the Control key, while typing the letter C once). To 
return to the editing window without typing a command, type <CR> on an empty 
command Line. To type a command and Leave the cursor in the command window, 
terminate the command with <CNTL-C>. These functions may differ according to 
your context file. 

The stream name for the 6Edit editing window is the second lowest unused UC 
stream greater than UC09 (usually UC11). Additional editing windows start at 
the next unused UC stream (usually UC12 and higher). 



Vertical Scroll Margins 



The editing window has two vertical "scroll margins." These margins are the 
top and bottom subportions of the editing window: 
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Figure 2-2. Vertical Scroll Margins 



6Edit keeps the cursor out of the scroll margins whenever possible. (An 
exception is when the editing window displays the beginning or end of the 
file, so you cannot scroll any more in that direction.) Thus, text surrounds 
the cursor at all times. If you try to move the cursor into a scroll margin, 
6Edit scrolls the data so the cursor is no longer in the scroll margin. 
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You can change the size of the scroll margin, from a minimum of zero Lines to 
a maximum of half the editing window height. To do this, assign a number to 
the predefined name "$\/SCR0LL_MAR6IN" . (See Appendix A, Predefined Names.) 



Horizontal Scroll Margins 



In addition to scrolling vertically, the 6Edit window can also scroll 
horizontally. Horizontal scroll margins act on the same principle as vertical 
scroll margins; however, horizontal margins scroll from right to left, or from 
left to right. 

These margins are located at the right and left of the editing window: 
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Figure 2-3. Horizontal Scroll Margins 



6Edit keeps the cursor out of the scroll margins whenever possible. If you 
try to move the cursor into the margin, 6Edit scrolls the data so that the 
cursor is no longer in the margin. 

You can change the size of a horizontal scroll margin, from a minimum of zero 
columns to a maximum of half the editing window width. To do this, assign a 
number to the predefined name "$HSCR0LL_MAR6IN". (See Appendix A, Predefined 
Names. ) 
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6Edit supports a special feature caLLed "wordwrap." As you type text, 6Edit 
allows you to type as far as the right margin; when you cross that margin, 
wordwrap automatically replaces the last word of the record at the beginning 
of a new record. Thus you can enter text without ever pressing the Return 
key. 

You can enact the wordwrap mode with the SWORDWRAP predefined name. (See 
Appendix A, Predefined Names.) The value assigned to SWORDWRAP is the right 
margin column number you choose. A value greater than 11 implements the 
wordwrap mode. To discontinue the wordwrap mode, set SWORDWRAP to 0 or 1; 
this is the default. 



Mu 1 1 i p I e Ed i t i ng Hi i ndoujs 

Multiple editing windows are permitted. The WINDOW commands, explained in 
Section 3, allow you to create and remove editing windows. (There will always 
be just one command window.) At any one time, you're working with just one 
editing window, called the "current" editing window. 

Each editing window remembers its own instances of: 

the edit block ("CURRENT"); 

the edit block stack (for "EDIT PREVIOUS" and "EDIT NEXT"); 
the file pointer ("HERE"); 
the selected block ("THAT"). 

Different editing windows can be editing the same file or different files. 
You can select a block in one window, switch to a different editing window, 
and insert the data in the new window. 

The editing windows must be created either side-by-side (horizontal windows), 
or stacked one above the other (vertical windows). The horizontal and 
vertical modes of window creation are illustrated in the following figure. 
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command window 



command window 



ed. I ed. I editing 
win. I win. I window 
#1 I #2 I #3 



editing window #1 



editing window #2 



Horizontal editing windows 



Vertical editing windows 



Figure 2-4. Two Styles of Multiple Editing Windows 



The "mode" for creating new editing windows (horizontal or vertical) is 
determined when the second editing window is created. To switch "modes", you 
must remove all but one editing window, and create a second editing window in 
the desired mode. Only vertical mode is implemented in A03 6Edit, however. 

The minimum window size is: for horizontal windows, ten positions; and for 
vertical windows, one line plus the border, if present. The only practical 
limit on the number of windows which can be created is the size of the 6Edit 
screen. 

Editing windows are numbered starting at one, top-to-bottom or left-to-right. 
The predefined name $WI_BORDER controls borders between windows. The value of 
$WI_BORDER is a single character, or no characters (the empty string); the 
initial value is "-". This character will be used to form the border between 
windows; if $W1_B0RDER is set to the empty string, then borders are not used. 

To move the cursor from the current editing window to the next one, type 
<CNTL-N> (hold down the Control key, while typing the letter N once). The 
cursor can be in the current editing window or the command window. If the 
current editing window is the Last one, <CNTL-N> moves to the first one. 
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Screen Appearance 



Input Editing Functions 

Generally, input editing functions affect characters under or near the cursor 
by moving, deleting, etc. 

These key sequences are those in effect at logon, before any new IMP keys are 
designated. You, the user, may redefine these keys on your terminal keyboard. 
(See Appendix D, Customizing the 6Edit User Interface, for more information.) 
If you decide to redefine the standard key sequences, those listed here (and 
in Appendix E) may not work as described. 

Input editing functions may be typed at the keyboard directly, by typing a 
sequence of one, two, or three keys. 

The following paragraphs describe the key sequences you can use to move the 
cursor, replace, insert, and delete characters, and split and join records. 
These input editing functions are executed by the Front End Processor. (See 
Appendix E for a complete list of input editing functions.) 

IVIovIng the Cursor 

The following key functions move the cursor (and, when necessary, scroll the 
data in the editing window). These functions do not change the data in the 
file. 



Table 2-2. Cursor Key Functions 



Command Function and Description 



<BS> or <CNTL-H> 

Backspace. 



<CNTL-R> 

Forward space. 
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Table 2-2. Cursor Key Functions (cont) 



Command Function and Description 



<TAB> or <CNTL-I> 



Tab. 



<CNTL-W> 

Move to right/left word. 

Moves the cursor to the right or Left word. The direction in 
which the cursor moves depends on the Last <BS> or <CNTL-R> key 
typed. 

A "word" represents a contiguous string of non-space 
characters. Any number of spaces may appear between words. 
ALL spaces are skipped when moving to the next word. If the 
recordwrap mode is disabled, this key function is Limited to 
the current record; when you reach the beginning or end of the 
record, this function changes direction and moves to the next 
word in the opposite direction. If the recordwrap mode is 
enabled, this key function will move to the next or previous 
record when it hits the edges of the current record. (See the 
SRECORDWRAP predefined name in Appendix A, Predefined Names.) 

You can use the KEYIN command to define keys that can move 
either left or right to the previous or next word. (See the 
examples for the KEYIN command in Section 3.) 



<ESC> <CR> 



Move cursor to beginning of current record. 



<ESC> <N> 



Move cursor to the end of current record. 
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Table 2-2. Cursor Key Functions (cont) 



Command Function and Description 



<CR> 

Move cursor to beginning of next record. If the cursor is in 
the command window, <CR> returns the cursor to the current 
editing window. 



<ESC> <A> 

Move cursor up one record. 



<ESC> <B> 

Move cursor down one record. 

For <CR>, <ESC> <A>, and <ESC> <B>, the cursor moves by 
records, not by Lines on your terminal. If a record occupies 
more than one line of the display, "move cursor up" moves the 
cursor to the same position of the previous record, (not the 
previous line). This movement may appear to jump over terminal 
lines. The same is true of "move cursor to beginning of next 
record" and "move cursor down". 



<CNTL-C> 

Moves the cursor to the command window. This function may also 
be used to terminate a command and keep the cursor in the 
command window. 



<CNTL-N> 

Moves the cursor from the current editing window to the next 
one. If the current editing window is the last one, it moves 
the cursor to the first one. From the command window, <CNTL-N> 
is equivalent to <CRxCNTL-N>. 



The context file that 6Edit reads initially may have defined other keys on 
your terminal keyboard, to move the cursor over groups of records, or to 
search the file for specific data. 
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Replacing and Inserting Characters 

There are two modes avaiLabLe for typing data in 6Edit: the replacement mode 
and the insertion mode, (There is another mode, the overstrike mode, but its 
use is more specialized, and is not described here.) These modes are 
available whenever you use CP-6; they are described here only because they are 
particularly helpful when using 6Edit. The following paragraphs provide an 
introduction to these modes. (For detailed information on their use, see the 
CP-6 Programmer Reference (CE40), Section 6, Terminal Control.) 

You may do all your editing in either mode, or you may switch between modes. 
The technique you use is a matter of personal preference as well as the nature 
of your editing. 

Rep I acement Mode 

When you logon to CP-6, you are initially in the replacement mode. In this 
mode, each character you type replaces the character under the cursor. You 
can insert characters into a record at the end of the record. To insert 
characters anywhere else in the record, you must define an "insertion window" 
by typing <ESC> <J>, or <ESC> <»; then, characters you type at the right end 
of the insertion window are inserted into the record at that point. 

The insertion window "encloses" the action of many input editing functions. 
For example, the <ESC> <CR> sequence moves the cursor to the beginning of the 
insertion window. If you move the cursor beyond the insertion window, the 
window expands, encompassing the entire record. 



I nsert i on Mode 

As an alternative to the replacement mode, you can use the insertion mode. To 

tell the system to use the insertion mode, enter <ESC> <'>. Later, to return 

to the replacement mode, enter <ESC> <M>. Or use the SINSERT predefined name. 

The insertion mode inserts characters into the record; it never replaces 
characters. To replace characters in the insertion mode, you must first 
delete the characters you want replaced, then insert the new characters. 

If you define an insertion window in the insertion mode, it maintains many of 
the same effects as in the replacement mode. For example, many of the input 
editing functions are limited to the insertion window. However, regardless of 
whether the cursor is at the end of the insertion window, all characters typed 
are inserted into the record, they never replace characters already there. 
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Deleting Chau-acters 

You can delete characters in several ways. 



Table 2-3. Delete Functions 



Command Function and Description 



<DEL> 

Delete character. 

Usually deletes the character under the cursor. However, in 
the replacement mode only, if the cursor is at the end of the 
insertion window, <DEL> deletes the character to the left of 
the cursor. 



<ESC> <DEL> 

Delete left character. 

Always deletes the character to the left of the cursor. 



<ESC> <CNTL-K> 

Delete characters from the beginning of the record up to the 
character just to the left of the cursor. 



<ESC> <K> 

Delete the character under the cursor and all characters to the 
right to the end of the record. 



<ESC> <CNTL-L> 

Delete the record from the file. 

This is the same as <ESC> <X>, but it also deletes the record 
from the file. 



CE70-02 



Using 6Edit 
Deleting Characters 



2-17 



Table 2-3. Delete Functions (cont) 



Command Function and Description 



<ESC> <CNTL-W> 

Delete word. 

Deletes the character under the cursor, and all characters to 
the right up to the start of the next word. 

You can use the KEYIN command to define keys that can delete 
either the previous or the next word. (See the examples for 
the KEYIN command in Section 3.) 



<ESC> <X> 

Delete the entire record. 

This does not remove the record key from the file, but does 
delete all characters in the record. 



<CNTL-X> 

Same as <ESC> <X>. 



Splitting and Joining Records 

Splitting records allows you to insert blank lines, and add new records to the 
file. Type <ESC> <LF> to "split" a record, i.e. break it up into two separate 
records. The characters under and to the right of the cursor are removed from 
the current record and placed in a record which is inserted into the file 
following the current record. To insert new records in the middle of a file, 
type <ESC> <N> to go to the end of the record, and then type <ESC> <LF>. This 
creates a new record after the initial record. 

Another way to insert records in the middle of a file is from the beginning of 
the record. Type <ESC> <CR> to go to the beginning of the record. Then type 
<ESC> <LF>. This creates a new record at the cursor line. 

To add data at the end of a file, go to the end of the file, using the EO CURR 
command in the command window. This command positions the cursor on a blank 
line. Type the new record. Then type either <CR> or <ESC> <LF>. 



2-18 



Using 6Edit 
Splitting and Joining Records 



CE70-02 



Using <ESC> <BS>, you can join two records together into one record. This 
function works only when the cursor is at the beginning or the end of the 
record. If the cursor is at the beginning of the record, it joins this record 
to the previous record. If the cursor is at the end of the record, the 
following record attaches to the Last character of the cursor record when you 
type <ESC> <BS>. 

The presence of a blank space between words when joining or splitting Lines is 
controlled by the STEXTEDIT predefined name. See Appendix A for details. 



Ser i a I Ed i t i ng 

6Edit provides the serial editing mode for circumstances when full-screen 
editing is inappropriate or inefficient. These cases are as follows: 

o When using 6Edit non-interact ively (i.e., as a result of the IBEX BATCH or 
XEQ commands) 

o When using 6Edit online at a non-CRT terminal that permits neither full 
screen display nor scrolling 

o When using 6Edit to perform well-defined editing tasks such that it is 

more efficient not to wait for the editing window to be filled with a full 
screen of data every time the file pointer is pointed elsewhere within the 
file. 

Note that in serial editing, window-specific values for EQUALS-names and 
KEYINs are ignored, as is the size and position of a new window created with 
the WINDOW command. 

When serial editing, a block expression by itself as a command (with no 
editing verb such as COPY or AFTER) moves the file pointer without displaying 
any data. To display data, an explicit DISPLAY command is necessary. 



Switching between Serial and Screen Editing 

When 6Edit is started, it determines if the user is running online and if the 
terminal can support screen editing. If the user is not online or if the 
terminal profile reveals that the terminal cannot screen edit, 6Edit forces 
the user into serial editing mode. That is, it sets the predefined name 
SSCREEN to 0 (the height of the terminal "screen"). 

The online CRT user choose between serial editing and screen editing by 
setting SSCREEN back to the number of lines that 6Edit should use as the 
screen size. Setting SSCREEN to ON (or 1) restores the current maximum screen 
size allowed. Setting SSCREEN to OFF (or 0) enters serial mode. 
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Manipulating Data in Serial Editing Mode 



In serial editing mode, with SCOMMAND set on (the default), 6Edit commands are 
used to manipulate the data. With SCOMMAND off, 6Edit prompts with the key of 
the "here" record, and uses reread mode for editing the data. 

Special activation characters perform special functions: 

<LF> terminates editing of the current record, and moves to the next one. 
<LF> is <CNTL-J>. 

<EOT> terminates editing of the current record, and moves to the previous one. 
<EOT> is <CNTL-D>. 

<SYN> splits the current record at the cursor position, and possibly moves to 
the new one, depending on whether it is empty. If wordwrap is set, typing 
at the end, past the wordwrap position, will cause the insertion of a new 
record just as it does in screen editing mode. <SYN> is <CNTL-V>. 

Other activation characters (i.e., all normal ones plus <ETX>) cause a command 
prompt, just as in screen editing. 
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Section 3 

6Edit Commands 



This section describes in detail each of the commands supported by 6Edit. 



Entering Commands When Full -Screen Editing 

When you are full-screen editing in 6Edit, your terminal's display screen is 
divided into two "windows." Commands for 6Edit may only be entered when the 
cursor is in the upper window, which is called the "command window." If the 
cursor is in the lower window, you can move it to the command window by typing 
<CNTL-C> on your terminal. Hold down the Control key, as if shifting, then 
type the "C" key. This keystroke may differ according to your context file. 
(See Appendix C, Context Files in 6Edit, for standard key definitions.) 

When the cursor is in the command window of the screen, you can enter command 
lines normally. You can use all the features described in this section. 



Command Summary 

There are three categories of commands in 6Edit: editing, assignment, and 
housekeeping. The general syntax for all 6Edit commands is shown in Table 
3-1. 



Table 3-1. 


Command Summary 


Type Syntax 


Description 


Editing Commands 




6E[DIT] file 


Begin editing (by displaying the 




specified block) 


6B[UILD] file 


Create a new file 


6X file 


Edit block in protected mode 


ED[IT] block 


Begin editing (sets edit block) 


[DI[SPLAY]] block 


Display a block 


CO[PY] {blocklstring} 


Set source for copy operation 
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Table 5-1. Command Summary (cont) 



Type Syntax 



Descr ipt ion 



MO[VE] block 

AF[TER] block 
OV[ER] block 
DE[LETE3 block 



Set source for copy; delete 
after copy 

Copy source, inserting after block 
Copy source, replacing block 
Delete a block 



Assignment Commands 

name EQ[UAL[S]] string 
LO[CATION] name [IS] block 
SY[NONYM] name [IS] fragment 
KE[YIN] str_1 IS str__2 

Housekeeping Commands 
TIME 
DA[TE] 

DIR[ECTORY] [f id I R[ESET]] 
{DO I ! } command 

H[ELr] [(processor)] [topic] 

IF str [cd];cds[;ELSE [cd];cds] 
READ fid 

OUT[PUT] [Location] [optlist] 
PRINT [ALLI Idevlist] 

ERASE [ALLI Idevlist] 
EN[D]IX[IT]IQ[UIT] 
REST[ORE] fid 

SAVE [option] {TOIONIOVER} fid 
SH[OW] option 



[function] WI[NDOW] [option] 



Assign string value to name 
Make name refer to block 
Make name a synonym for fragment 
Redefine a terminal key 



Display current date and time 

Display current date and time 

Change default account and 

packset name 

Call another processor 

Display specified on-line 

information 

Conditionally execute commands. 
Read 6Edit commands from fid 
Send output to specified location 
Direct accumulated output to 
destination 

Delete specified output 
Exit 6Edit 

Restore context information from 
fid 

Save current context information 
Displays strings, assigned 
names, records in a block, keyin 
definitions, and windows 
Creates a new editing window, 
changes current editing window, 
or switches to another editing 
window 
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Command Summary 



AFTER Command 

Syntax: 

AF[TER] [BL[OCK]] bLock_express ion 
Parameters: 

bLock_express ion specifies the Location at which to insert the source 
block. 

Descr ipt ion: 

The AFTER command is used to insert a block of data into a file. The 
bLock_express ion specifies the destination Location for the insertion 
operation. The current source block is inserted into a Location just after 
the end of the block specified by block_express ion. (The source block was set 
by the last COPY or MOVE command.) 

The source and destination blocks may be whole records, parts of records, or 
any combination of these. 

Example: 

COPY 1 THRU 5 AFTER 10 

inserts a copy of records 1 through 5 after record 10. 
COPY 1 THRU 5 AFTER FILE OCTOBER__BILLS 42 

copies records 1 through 5 to record 42 of the specified file. 

Related Topics: 

Copy/Move Operations 
COPY Command 
MOVE Command 
OVER Command 
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AFTER Command 



COPY Command 



Syntax: 



CO[PY] {[BL[OCK]] bLock_expression} 
{ST[RIN6] str ing_expression} 



Parameters: 



bLock_expression 



is the block of data to be copied. 



str ing__express ion 



is the string of characters to be copied. 



Descr ipt ion: 

The COPY command specifies the source block for the next AFTER or OVER 
command. 

The COPY command is a passive command. To have any effect, it must be 
followed by an AFTER or OVER command. 

6Edit remembers the location of the source block for use later by the AFTER 
and OVER commands. 

If block_expression is given, then 6Edit simply remembers the location of the 
block specified, it does not keep a separate copy of the data. If 
str ing_express ion is given, then 6Edit keeps a copy of the value of 
str ing_expression for later use by the AFTER and OVER commands. 

Example: 

COPY 2 PO 10 THRU EO 4 

specifies a source block which begins at position 10 of record 2, and ends at 
the end of record A. 6Edit ignores this data until it receives the next AFTER 
or OVER command. 

COPY ST 'X' OVER REPEAT SELECT 'Y' 

replaces all 'Y*s with 'X's. This command searches for 'Y's starting at the 
current file pointer location, and proceeds to the end of the edit block. 
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COPY Command 



Related Topics: 



Copy/Move Operations 
MOVE Command 
AFTER Command 
OVER Command 



DATE Command 

Syntax: 
DATE 

Parameters: 
None 

Descr ipt ion: 

DATE (a Synonym for the TIME command) displays the current date and time. 

Example: 

DATE 

requests a display of the current data and time. A sample display is: 
MAY 22 '81 14:39 
Related Commands: 
TIME 

DELETE Command 
Syntax: 

DE[LETE] [BL[OCK]] block__express ion 
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Parameters: 

bLock_expression is the block of data to be deleted. 
Descr ipt ion: 

The DELETE command deletes its operand. After deleting the block, the 
location vacated by the block becomes the new selected block. Note that this 
is an "empty" block: it contains no data characters. 

Note that "block_expression" can explicitly specify an entire file (e.g., 
"FILE filename"). In this case, the file itself is deleted, not just the 
records in it. 

If a file is open for editing when DELETE FILE is entered, the editing window 
is cleared, and the following messages appear in the command window: 

* File filename deleted. 

★ EDIT PREVIOUS will restore the Edit Block. 

If the file open for editing was the one deleted and no other files are in the 
edit block stack, the EDIT PREVIOUS message is not issued. A deleted file 
cannot be restored by 6Edit. 

If the file open for editing was a file other than the one deleted, then 
entering EDIT PREVIOUS will return that file to the screen. 

Example: 

DELETE 5 

means delete record 5. 

DELETE BO CURRENT THRU 5 PO 20 

means delete everything from the beginning of the current edit block through 
record 5 position 20. 

DELETE FILE TRANS 

means delete the file TRANS and all the records in it. 
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DIRECTORY Command 



Syntax: 

DIR[ECTORY] [f id I R[ESET]] 
Parameters: 

fid is a fid containing only an account name^ and an optional packset name. 
Description: 

The DIRECTORY command changes the default account and packset for fids. These 

defaults are used if a fid in any later command does not include an account 
and packset name. If neither the fid nor the RESET option is included, 6Edit 
simply displays the current directory. 

The RESET keyword specifies that the default account and packset name are to 
be reset to the user defaults (i.e., the defaults in effect when you logged on 
to the system). 

Example: 

DIR .SYSLIB 

directs subsequent fids that do not include an account to default to the 
.SYSLIB account and to the packset associated with that account. 



DISPLAY Command 
Syntax: 

[DI[SPLAY]] [BL[OCK]] bLock_express ion 
Parameters: 

block_expression is the block of data to be displayed. 
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Description: 



The DISPLAY command displays the value of its operand. 
DISPLAY SKIP 20 RECORDS 

means move the cursor to the record which is 20 records beyond the current 
cursor record. A section of the file surrounding this record is displayed in 
the editing window. 

SKIP 20 RECORDS 

performs the same function as the above command, except that 6Edit does not 
forget the block selected before the command; it simply changes the block's 
boundar ies . 

DISPLAY 428. 5 

means move the cursor to the record in the current edit block with key 428.5. 

The verb DISPLAY may be omitted from the command line. However, there is a 
variation in the command's effect: when the verb DISPLAY is given, 6Edit 
forgets any block selected prior to the command, and the block_expression in 
the DISPLAY command becomes the new selected block. 

On the other hand, when the verb DISPLAY is omitted, block_express ion only 
changes part of the specification of the block being selected (if any) prior 
to this command. For example: 

Form Result 

5 Moves the cursor to record 5.0 

THRU Begins selecting a block 

10 The selected block is now 5.0 THRU 10.0 

SKIP 3 RECORDS The selected block is now 5.0 THRU 



DI SKIP 3 RECORDS Forgets the former selected block; 

the selected block is now the third 
record after record 10.0 

In serial editing mode, the DISPLAY command displays only the complete records 
constituting the selected block (through M$L0), and only if the verb DISPLAY 
is used explicitly. 



the third record after 10.0 



Compare the above 



sequence of commands with the following: 



5 

THRU 
10 



Moves the cursor to record 5.0 

Begins selecting a block 

The selected block is now 5.0 THRU 10.0 
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DISPLAY Command 



DO Command 

Syntax: 

{DOI !} command 
Parameters: 

command specifies an IBEX- Level command. 
Description: 

The DO command is used to call another processor from within 6Edit. 



EDIT Command 
Syntax: 

ED[IT] [BL[OCK]] bLock_express ion 
Parameters: 

block_expression is the block of data to be edited. 
Description: 

The EDIT command causes its operand to become the new "edit block." The edit 
block is used by 6Edit in block expressions; it limits pattern searches^ and 
is the implicit file in which you move the file pointer. (See Section 5, 
Block Expressions in 6Edit.) 

The previous edit block is not forgotten. Its specification remains in the 
edit block stack. 

The block__expression is not required to specify an entire file; however, the 
block it specifies must begin and end on record boundaries, that is, 
block__expression must specify some number of complete records. 

Sometimes it is convenient to Limit file pointer movement to some sub-portion 
of the file. EDITing a sub-portion of a file also Limits the display of data 
around the file pointer, which can be useful when your terminal operates at a 
low speed (thus displaying data takes longer). 
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EDIT Command 



The predefined name "CURRENT" is set by 6Edit automat icaL Ly whenever the EDIT 
command is given. The value of "CURRENT" is the Location of the current edit 
block. For example, the block expression "EO CURRENT" moves the file pointer 
to the end of the current edit block. 



You use the EDIT command when creating a new file. Type the command 

EDIT NEW FILE fid 
at the asterisk prompt. 
Example: 

EDIT FILE OPPORTUNITY^KNOCKS 

begins editing the file "0PPORTUNITY_KN0CKS". An entry for this new edit 
block is added to the edit block stack. 

EDIT NEW FILE ACCEPTANCE__LETTER 

creates a new file "ACCEPTANCE__LETTER", and begins editing it. An entry for 
this new edit block is added to the edit block stack. 

EDIT 50 THRU 15286 

edits a sub-portion of the current edit block. Specifically, the new edit 
block starts at record 50.0 and continues through (and including) record 
15286.0. An entry for this new edit block is added to the edit block stack. 

EDIT PREVIOUS 

reverts to editing the block whose specification was saved in the edit block 
stack immediately prior to the current edit block. The edit block stack is 
not altered, but the "CURRENT" entry changes. 

Related Topics: 

Edit Block 

Edit Block Stack 
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END, EXIT, QUIT and XIT Commands 



Syntax: 



{E[ND] I EX[IT] IQ[UIT] IXCIT]} 

Parameters: 

None 

Description: 

This command terminates 6Edit. Control is returned to the command processor 
(IBEX). 

The keywords, END, EXIT, QUIT, and XIT perform exactly the same function. All 
editing changes you made during an editing session take effect when you change 
the record. Therefore, you can terminate 6Edit at any time without losing any 
of the editing work you have done. 

However, any name settings (such as KEVINS, SYNONYMS, EQUALS, and LOCATION 
names) that you made during the session will be lost when you type the END 
command and leave 6Edit. 



EQUALS Command 



Syntax: 



[ {CO[MMAND] [WI[NDOW]] }] 
name EQ[UALS] stringL.expression [IN {ED[ITING] [WI[NDOWS]]}] 

[ {WI[NDOW] window_num }] 



Parameters: 



name is any name; it must be between 1 and 31 characters in length. The 
"name" may include: 



o Alphabetic characters 

o Digits (except as the first character of name) 
o $ _ # and S) 



str ing__expression 



is any string expression. 



window num 



is a number between 1 and the number of editing windows. 
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EQUALS Command 



Descr ipt ion: 



The EQUALS command assigns the value of str ing__expression to name. The name 
may be a predefined name, a name you previously created with an assignment 
command, or a new name you are creating now. 

When you type an EQUALS command, 6Edit evaluates str ing[_express ion to yield a 
string of characters. (If numbers were used or computed in str ingL_expression, 
6Edit converts them to character form using decimal representation.) 6Edit 
assigns this character string to name. Thereafter, name can be used in string 
or block expressions; 6Edit replaces it with the character string which was 
assigned to it by this EQUALS command. 

Note: Except when name is $INTR0_1 or $INTR0_2, SCONTROL functions in the 
character string are not interpreted when assigned but only when the resulting 
variable is used in a different command. 



The value of name will not change until you explicitly assign a new value to 
it. (Certain predefined names disobey this rule; 6Edit updates their values 
internally at certain points in the processing of commands.) 

The IN-clause can be appended to the EQUALS command only when name is one of 
the following predefined names: 



SAUTOTAB $INTR0_2 

$END__MARK $KEY_6ENERATI0N 

$EZ_APPEND SRECORDWRAP 

SHSALL SSCROLL 

SHSCROLL STEXTEDIT 

$HSCROLL_MARGIN SVSCROLL 

SINSERT $VSCR0LL__MAR6IN 

$INTRO 1 SWORDWRAP 



If you include the IN-clause when assigning a value to one of these predefined 
names, then the value affects only the command or editing window, depending on 
which is specified. If you omit the IN-clause when assigning a value to one 
of these predefined names, then the value affects both the command and editing 
windows. Note that SSCROLL works only in the command window. "IN EDITING 
WINDOW" causes all editing windows to be affected. "IN WINDOW window_num" 
affects only the specified window. 

For details on the predefined names listed above, see Appendix A, Predefined 
Names . 



3-12 



6Edit Commands 
EQUALS Command 



CE70-02 



Example: 



MODEL EQUALS MODEL .PLUS. 3 

increments the value of MODEL (a hypothetical name you have already defined) 
by 3. 

SWORDWRAP EQUALS 76 

sets the value of the predefined name SWORDWRAP to 76 (i.e.^ enables wordwrap 
mode. Limiting Lines to 76 characters). See Appendix A, Predefined Names, for 
details on the SWORDWRAP name and wordwrap mode. 

$HSCROLL_MARGIN EQUALS 5 IN COMMAND WINDOW 

enables horizontal scrolling in the command window only. It does not affect 
horizontal scrolling in the editing window. 

$INTR0_1 EQUALS $KEY(F4) 

sets the primary introducer for KEYIN names to SKEY(F4). This permits 
definitions of keyins such as KEYIN $KEY(FA) I I 'R' IS ... to establish the 
actions taken when you type F4 followed by R. See the KEYIN command, later in 
this section, for details on the use of KEYIN and the SKEY(keyname) predefined 
string function. 



Related Topics: 
Substitution 



ERASE Command 
Syntax: 

ERASE [ALLI Idevlist] 
Parameters: 

ALL specifies that the accumulated outputs for all logical devices are to 
be deleted. This is the default. 
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LdevList specifies that the accumulated outputs for the specified Logical 
device or devices are to be deleted. The list is entered in the format 

ldevname[,ldevname] . . . 

Idevname is a logical device name established through the LDEV command. 

Description: 

ERASE deletes the accumulated output for logical devices. 

Example: 

ERASE ALL 



deletes all output accumulated for all 
or job. 

Related Commands: 



logical devices defined for the session 



PRINT 



HELP Command 

Format: 

H[ELP] [(fid)] [TOPICS] [keywordi [-] [keywordZ] 

Note: The following elements can be specified in any order: 

(fid) 
TOPICS 

[keywordi] [-] [keyword2] 
For example, HELP (fid) keywordi - keywordZ TOPICS is acceptable. 
Parameters: 

(fid) specifies the processor name (for example, 6EDIT). If (fid) is 
omitted, the current processor is assumed. 

TOPICS requests a list of topic or subtopic names, rather than an 
information message. 
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Form 



Result 



HELP (fid) TOPICS 

HELP (fid) TOPICS keywordi - keywordZ 

HELP (fid) TOPICS keywordi? 

HELP (fid) TOPICS keywordi 



Lists all topics 
Lists aLL topics in the range 
specified by keywordi - keyword 2 
Lists aU topics beginning with 
the prefix specified by keywordi 
Lists all subtopics for the 
topic specified by keywordi 



keywordi [- [keyword2]] specifies a topic, a range of topics, or a topic 
and subtopic to identify what HELP information is requested. 



Form 



HELP (fid) keywordi 



Result 



HELP (fid) keywordi keyword? 



Displays the first Level 
information message for 
the topic keywordi 
Displays the information 
message for keywordi, but only 
the level identified by the 
subtopic keyword? 
HELP (fid) TOPICS keywordi [-] [keyword2]Lists topic or subtopic 

names. See TOPICS parameter. 

keywordi may include the wildcard (?) character as the rightmost character, if 
TOPICS is specified. 

Descr ipt ion: 

HELP displays information. 

HELP messages have levels. Once the initial level has been displayed, 
entering a question mark displays the next level, usually containing greater 
detail. Entering two question marks displays the entire message. 

The standard HELP command is provided by most processors. The HELP facility 
for each processor is available only to users with sufficient privilege to use 
the processor itself. The HELP command can be used either within the 
processor or in IBEX. 
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IF and ELSE Commands 



Format: 



IF stringL_expr [command] ; commands [; ELSE [command] ; commands] 



Parameters: 



str ing__expr 



specifies an expression that evaluates to a number. 



command 



specifies any 6Edit command. 



commands 



specifies any 6Edit commands. 



Descr ipt ion: 

The IF and ELSE commands permit conditional execution of multiple commands in 
a single command Line. If the string expression evaluates to a number greater 
than zero, any commands preceding the corresponding ELSE are executed, and the 
rest of the line (ELSE and beyond) is ignored. If the string expression 
evaluates to zero, the commands following ELSE are executed = 

The IF/ELSE construct can be nested to any depth. 

Examples: 

IF SAUTOTAB PO NU SAUTOTAB; ELSE PO NU 1 

positions to the autotab column of the current record. 

RE 'bird'; IF SMATCHES COPY STRING 'bath' AFTER 80 •%R' 

appends the word "bath" to the next record containing the word "bird". 

KEYIN Comnnand 
Syntax: 

KE[YIN] str ingL_expression_1 IS str ing_expression_2 

[ {CO[MMAND] [WI[NDOW]] }] 
[IN {ED[ITING] [WI[NDOWS]]}] 
[ {WI[NDOW] window_num }] 
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Parameters: 



str ing__expression_1 specifies the character or character sequence to be 
typed on the terminal keyboard. It must evaluate to one, two, or three 
characters, or a function key name possibly followed by one character. 
Additional rules governing str ing__expression_1 are explained under 
"Description" below. 

str ing_expression_2 specifies the characters to be substituted for 
str ing_expression_1 when the latter is typed at the terminal keyboard. 
Information on expressing non-displayable characters in string expressionZ 
are explained under "Description" below. 

window__num is a window number between 1 and the number of editing windows. 
Descr ipt ion: 

The KEYIN command redefines the keys on your terminal. It is only effective 
when 6Edit is being used in the screen-editing mode, and the command stream is 
originating from your terminal. 6Edit uses the CP-6 IMP facility to perform 
substitution. 

After using this command, whenever the CP-6 system sees the 

str ing_expression__1 character(s) coming from your terminal, it acts as though 

you had typed str ing_expression__2 instead. The system even displays 

str ing_express ion_2 on your terminal, instead of the characters you had typed 

(that is, instead of str ing_expression__1) . 

Any character value may appear in either str ing_expression_1 or 

str ing_expression__2, including non-displayable characters. In 

str ing__expression_1, non-displayable characters represent control keys; in 

str ing_expression_2, they represent input editing functions. This distinction 

is important. For example: 

18 is the ASCII decimal code for <CNTL-R>. When "%V(18)" appears in 
str ing_expression_1, it represents the <CNTL-R> key on the keyboard, the 
meaning of which you can define using the KEYIN command. However, when 
"%V(18)" appears in str ing__express ion_2, it always represents the "move 
right one character" input editing function, no matter how you have 
redefined <CNTL-R>. (See Appendix E for a list of input editing 
f unct ions. ) 

The IN-clause can be appended to any KEYIN command. If you include the 
IN-clause, the str ingL_expression_1 key or key sequence is defined only in the 
command or editing window, depending on which is specified. If you omit the 
IN-clause, then str ing_expression_1 is defined in both the command and editing 
windows. 
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NOTE: Typing an immediate-type function before 6Edit has IMPed the key 

sequence to a typeahead-type function invokes an immediate-type function 
rather than the 6Edit definition of the key sequence. 



This situation occurs only when using immediate- type input editing 
functions. The immediate-type input editing functions are: 



ESC Sequences 



Control Characters 



<ESCxA> 
<ESCxB> 
<ESCx6> 
<ESCXH> 
<ESCXQ> 
<ESCxW> 
<ESCXY> 



<ESC> <CNTL-A> 
<ESC> <CNTL-B> 
<ESC> <ESC> 



<CNTL-Q> 
<CNTL-S> 
<CNTL-X> 
<CNTL-Y> 



To avoid this situation, use FCNTBL=CP5S2 with the IBEX TERMINAL command 
before invoking 6Edit. 

Defining a key sequence to be immediate-type in one window but 
typeahead-type in another window may give unpredictable results. Either 
key sequence definition could be used by the FEP, depending on where 6Edit 
is in its processing of the last terminal input. 

Several rules apply to str ing_expression_1 . 

0 If str ing_expression_1 evaluates to exactly one token (character or 

function key name), it may be any token value which can be generated at 
your terminal keyboard. 

o If str ing_expression_1 evaluates to two tokens the first must equal either 
the "primary introducer" or the "secondary introducer." These one- or 
two-token values are set by the predefined names "$INTR0_1" and 
"$INTR0_2"; initially, $INTR0_1 is the Escape character and $INTR0_2 has 
no value. (See Appendix A, Predefined Names. Also, refer to the CP-6 
Programmer Reference Manual (CE40) Section IMP, for an explanation of 
introducers.) 

In addition, the following rules apply. If str ingL.expression_1 is 

o 1 token long: str ingL_expression_1 need not match either $INTR0_1 or 
$INTR0_2. 

o 2 tokens long: the first character must equal either $INTR0_1 or $INTR0_2 
and the second must be a character (not a function key name). 
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o 3 tokens Long: the first two characters must equal $INTR0__1 or $INTR0_2. 
Only the first can be a function key name. 

The last or only character of str ina_expression_1 may be any character value 
which can be generated at your terminal keyboard. 

Non-dispLayable tokens may be included in either str ing_expression_1 or 
str ing_expression__2. You can enter these tokens in str ing_expression_1 or 
str ingL_expression_2 in one of these ways: 

o Using the $KEY(keyname) predefined string function or its equivalent 

notation: <keyname>. The parameter for this function is a keyname, such 
as ESC. For example, the F1 function key may be represented as $KEY(F1) 
or as <F1>. To obtain the spelling for any non-displayable key, use the 
IMP command SPELL. 

A unique feature of the $KEY predefined string function is that it can be 
used to represent a function key that sends one, two, three, or even four 
characters. These keys may be functions keys such as F1 or SF1 (i.e.. 
Shift F1). For PCs operating with PCT, $KEY may be used to assign meaning 
to Alt-Fn or Cntl-Fn keys (see Appendix C and D for details). 

o Using the $CNTL( ' char ' ) predefined string function or its equivalent 

notation: <CNTL-char>. The parameter for this function, "char", is any 
character which when pressed with the CNTL key sends a control character. 

o Using the $CONTROL-Value function. The parameter for the function is the 
ASCII decimal code for the control key (e.g., <CNTL-D>), or the ASCII 
control character (e.g., <ESC>) that you are defining. (See Appendix F 
for the ASCII names, their control characters, and their decimal codes.) 
In the example, 

KEYIN •%V(27)0* IS ... 

%V(27) represents the <ESC> control character; %V is the SCONTROL-Value 
function and (27) is the ASCII decimal code for <ESC>, which in this 
example is defined as being followed by the zero character. 

o Using EQUALS names that you have previously defined, usually in your 
context file. The standard context file (see Appendix C) defines names 
for the most common non-displayable characters: ESC for <ESC> and CR for 
<CR>. Then, use the CONCATENATE operator to combine the name with other 
characters to comprise str ingL_expression_1. For example: 

KEYIN ESCI I 'L' IS... 
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$KEY and $CNTL or their angle bracket notations provide advantages over the 
other two methods of expressing non-dispLayabLe characters. The chief 
advantages are as follows: 



o Se I f -document ing commands. 

Expressing keystrokes as you see them on the keyboard makes it easier to 
remember how to invoke the keyin by looking at the command again, or 
displaying the available key ins with the SHOW command. 

o Expanded number of special sequences available at the terminal. 

Your terminal probably has keys that send two-, three-, or even 
four-character sequences when pressed; you can assign meanings within 
6Edit to many of these keys. Without $KEY, you would need to use both 
$INTR0_1 and $INTR0_2 if you assign both two- and three-character 
sequences, and you would find it quite difficult, if not impossible, to 
assign meanings to the four-character keys. 

Using the default single-character introducer, <ESC>, you might not be 
able to define enough functions to make editing convenient in your 
environment. You would then need to define some that require more than 
one keystroke to enter. Since most of the two-stroke sequences using 
<ESC> are already defined for input editing functions in the FEP, you 
would have to either give up some of those or use less-convenient 
three-stroke keyins. 

With $KEY, however, you can define all the single-stroke keyins without 
using either $INTR0_1 or $INTR0_2 at all. With the introducer names still 
free, you can then use any key as the introducer for up to two sets of 
two-stroke keyins. You can also choose as the introducer a key that sends 
more than one character. This is much more convenient to type than a 
control character, and does not force you to use a printing character. 
You then have the equivalent of four sets of keyins available instead of 
two. 

Examples: 

The examples below are numbered for ease of use. 
Example 1a. 

KE <ESC>II'L' IS <CNTL-C>I rSKIP 20 BO RECORDS ' I l<CR> 

causes the key sequence Escape-L to generate the characters ETX, SKIP 20 
BO RECORDS, and CR. When <ESC> <L> is typed at the keyboard, three things 
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happen: 



1. The <CNTL-C> character causes the cursor to move to the command 
window. Tnis occurs because <CNTL-C> is 6Edit*s input activation 
function to move the cursor to the command window. 

2. The command "SKIP 20 BO RECORDS" is entered in the command window. 

3. The <CR> character causes the command to be executed by 6Edit. 



Example 1b. 

KE ESC I I 'L' IS CMDII'SKIP 20 BO RECORDS' I ICR 

is identical to the previous command, but it takes advantage of EQUALS 
names. This command assumes that you have already entered the following 
command: 

ESC EQUALS <ESC>; CMD EQUALS <CNTL-C>; CR EQUALS <CR> 

Note that since str ing_expression_1 is two characters long in both of the 
above examples, $INTR0_1 or $1NTR0_2 must be set to <ESC> for the key 
definitions to work. 



Example 1c. 

By using the $KEY function in the above examples, $INTR0_1 or $INTR0__2 do 
not have to be used. With $KEY, any available single function key that 
sends a character sequence (usually ESC and something else) can be used 
instead of the Escape-L sequence to perform the "SKIP 20 BO RECORDS" 
f unct ion. 

Suppose F2 is the desired key for this function. The following KEYIN 
command can then be entered: 

KE <F2> IS <CNTL-C>I I 'SKIP 20 BO RECORDS ' I l<CR> 

With the EQUALS names defined as above, this command could also be entered 
as: 

KE <F2> IS CMDII'SKIP 20 BO RECORDS' I ICR 

If the F2 key on your keyboard sends <ESCxL>, these commands perform the 
same functions as the first two KEYIN commands above, but with a single 
keystroke, F2, and without having to first set an introducer character 
with SINTRO 1 or $INTRO 2. 
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Example 2: 



KEYIN 'XVCZS)' IS '%V(27)5R%V(23)' 
or 

KEYIN $CNTL(W) IS '%V(27)5R%V(23) ' 

defines the <CNTL-W> key, specified by %V(23), to move the cursor Left by 
one word. In this command: 

0 %V(27)5R is the ASCII decimal code for escape (<ESC>), followed by 
"5R". (See Appendix F for the ASCII character codes.) This input 
editing function sets the "left" direction for the "move one word" 
function to follow. (See Input Editing Functions in Appendix E for 
more information.) 

0 %V(23) is the ASCII decimal code for <CNTL-W>. <CNTL-W> is the "move 
one word" input editing function. 

If all the "one-stroke" function keys in your environment were already 
defined, and you might want to use a shifted function key instead of 
<CNTL-W>, so you could enter the following KEYIN command: 

KEYIN $KEY(SF3) IS •%V(27)5R%V(23) ' 

This performs the "move left one word" function with two keystrokes, 
Shift-F3. Single and shifted function keys can be defined in a similar 
manner for the rest of the examples below. 



Example 3: 

KEYIN <CNTL-E> IS •%V(27)5S%V(23) ' 

defines the <CNTL-E> key to move the cursor right by one word. In this 
command, similarly to Example 2, %V(27)5S sets the "right" direction for 
the "move one word" function to follow. 



Example A: 

KEYIN <CNTL-D> IS <ESC>I I '5R' I l<ETB>l KESOl l<ETB> 

defines the <CNTL-D> key to delete the word to the left of the cursor. In 
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this command: 

o <ESC>ir5R' is an input editing function that sets the "Left" 

direction for the "move one word" function to follow. (See Input 
Editing Functions in Appendix E for more information.) 

0 <ETB> is the ASCII character code for <CNTL-W>. This is the "move one 
word" input editing function; the cursor moves to the beginning of the 
previous word in the record. 

o <ESC>I l<ETB> are the ASCII character codes which comprise the "delete 
word" input editing function. 



Example 5: 

KEYIN <FF> IS <ESC>I l<CNTL-W> 

defines the <CNTL-L> key to delete the word under and to the right of the 
cursor. <FF> is the ASCII character code for <CNTL-L>. 



Example 6: 

KEYIN <CR> IS <ESC>II<LF> IN EDITING 

causes the carriage return key to generate the characters Escape and 
Linefeed, in the editing window only; it does not affect the carriage 
return key when the cursor is in the command window. 

This KEYIN is useful when you want to add several lines of text in the 
middle of a file, or if you are used to PC or UNIX editors where <CR> 
represents a record boundary. Normally, the carriage return key simply 
moves the cursor to the beginning of the next record; to add a new record, 
you must type <ESC> <LF> (the Escape and Linefeed keys). However, this 
KEYIN command allows you to use the carriage return key to generate the 
Escape Linefeed sequence. You must include an IN-clause in this KEYIN 
command because you do not want the carriage return key to generate <ESC> 
<LF> when you type it in the command window. By adding "IN EDITING" to 
the KEYIN command, the definition of the carriage return key in the 
command window is unchanged. 
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Related Topics: 
Substitution 



LOCATION Corrvnand 
Syntax: 

LO[CATION] name [IS] [BL[OCK]] bLock__expression 
Parameters: 

name is any name; it must be between 1 and 31 characters in Length. A name 
may include: 

o Alphabetic characters 

o Digits (except as the first character of name) 
o $ _ # and a 

bLock_expression specifies the block description of the new value of name. 

Descr 1 pt 1 on : 

The LOCATION command remembers the boundaries of its block operand as the 
value of name. Thereafter, you can use name in a block expression, and 6Edit 
interprets it to refer to the block specified by block_expression in this 
LOCATION command. 

The name parameter is required. It must be a name you create. 

The operand of the LOCATION command is called a "named block." 

Between the time the LOCATION command is given and the time of a reference to 
name, you should be aware that changes to the contents or location of the 
named block will effectively change the value of name as well, since name 
simply refers to the "location" of the named block, it does not hold a copy of 
the block's contents. 

Example: 

LOCATION CI IS 80 1 THRU A POSITION 15 

finds the specified block, and assigns the location of that block to the name 
C1. In subsequent commands, 6Edit evaluates CI as representing this location. 
For example: 
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COPY CI AFTER 7 



copies from the beginning of record 1 through column 15 of record 4. The data 
is inserted after record 7. CI stilL refers to the block located at 
BO 1 THRU A POSITION 15. It did not move with the data. 

Related Topics: 

Subst itut ion 



MOVE Command 

Syntax: 

MO[VE] [BL[OCK]] block__express ion 
Parameters: 

bLock_expression is the block of data to be moved. 
Description: 

The basic operation of the MOVE command is the same as for the COPY command. 
The operand becomes the new source block. 

For the MOVE command, however, 6Edit remembers that the source block is to be 
deleted after use. Later, when an AFTER or OVER command refers to the source 
block, it will delete the source block after copying it to the specified 
dest inat ion. 

After receiving this command, the operand becomes the new selected block. 
Example: 

MOVE 2 THRU 22 AFTER 40 

moves the records 2 through 22 to a new position after record 40. The source 
block (records 2 through 22) is deleted after being copied to its new location 
(after 40). 
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Related Topics: 

Copy/Move Operations 
COPY Command 
AFTER Command 
OVER Command 



OUTPUT Command 

Syntax: 

[[ON ] LP[aLocation]] 

OUT[PUT] [[OVER] fid ] [(option[,opt ion]. . .[)]] 

[[INTO] ME ] 
[[TO] ] 

Parameters: 

{ONIOVERI INTOITO) directs output processing. OVER causes an existing file 
to the overwritten. INTO causes file extension. ON and TO are synonyms used 
to create a new file. If the file exists, an error will occur. The default 
is ON. 

fid any valid CP-6 file identifier. 

LP directs output to the default line printer, ©location identifies a 
specific line printer. 

ME redirects output to the user's terminal. 

option is one of the following: 

F[ORM]={f ormname r f ormname' } FORM applies to unit record files and unit 
record devices. Specifies the name of a form to be mounted on a unit 
record device, formname is a 1-6 character string, which can be quoted. 
The name must have been defined to the system by the system manager (via 
the Form Definition File). The default is blank, which means the default 
form for a unit record device and form 'STDLP' for unit record files. 

I[XTNSIZE]=value Specifies an initial disk storage allocation (in 
blocks) for the output file, value must be in the range of 1 through 
134217727. The default is 2. 

0[RGANIZATION={C[ONSECUTIVE]IU[NIT]R[ECORD]} Specifies the organization 
of the output file as either CONSECUTIVE or UNIT RECORD. If this option 
is not specified, the output file is created as a UR file. 
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X[TNSIZE]=vaLue Use of this option causes an automatic MSEXTEND when 
needed. vaLue specifies a secondary disk storage allocation (in blocks) 
for the output file, and must be in the range 1 through 32000. The 
default is 2. 

Descr ipt ion: 

This command sends subsequent output to the specified file. 



OVER Command 
Syntax: 

OV[ER] [BL[OCK]] block_express ion 
Parameters: 

block_expression is the block of data to be replaced by the source block. 
Description: 

The OVER command is used for replacement. It is generally equivalent to first 
deleting the destination block by using block_expression, then inserting the 
source block into the location vacated by the destination block. (The source 
block was set by the last COPY or MOVE command.) 

The source and destination blocks may be whole records, parts of records, or 
any combination of these. 

Example: 

COPY 5 THRU A5 PO 10 OVER 230 THRU 460 

deletes any data characters that previously existed in records 230 through 
460. It then inserts the new data (from the beginning of record 5 through 
position 10 of record 45) at record 230. 

Related Topics: 

Copy /Move Operations 
COPY Command 
MOVE Command 
AFTER Command 
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PRINT Command 

Syntax: 

PRINT [ALLI LdevList] 
Parameters: 

ALL specifies that the accumulated outputs for all Logical devices are to 
be sent to their destinations immediately. This is the default. 

Idevlist specifies that the accumulated outputs for the specified logical 
device or devices are to be sent to their destinat ion(s) immediately. The 
list is entered in the format 

ldevname[, Idevname] 

Idevname is a logical device name established through the LDEV command. 

Descr ipt ion: 

PRINT directs that output accumulated for logical devices be sent to its 
destination immediately. 

Example: 

PRINT LP01,LP02 

causes the accumulated output associated with logical devices LP01 and LP02 to 
be sent immediately to the associated destinations. 

Related Commands: 

ERASE 
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Syntax: 
READ fid 
Parameters: 

fid is the fid of a fiLe containing valid 6Edit commands. 
Description: 

This command directs 6Edit to read the specified file (fid). The file 
specified by fid must contain one 6Edit command Line in each record. 6Edit 
reads the command Lines and executes them as if they had been typed at the 
terminal, except that KEYIN substitutions are not performed. 6Edit stops 
reading command Lines from the file when it reaches the end of the file; then 
it reverts to reading command Lines from the command stream. 

You may include a READ command as one of the commands in the file specified by 
fid. You may nest READ commands in this way indefinitely. 

When using multiple commands on a Line, the READ command can appear at any 
place on the command Line. 



RESTORE Command 

Syntax: 

REST[ORE] fid 
Parameters: 

fid specifies the fid of a file which was created with 6Edit's SAVE 
command. 

Descr ipt ion: 

The RESTORE command restores context information from a file which was created 
with the SAVE command. It merges the information from the SAVE-file with the 
current context in the following way: 

0 SYNONYMS and KEYINs from the SAVE-file are added to those already defined 
when the RESTORE command is given. 
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o Predefined EQUALS-names from the SAVE-fUe replace the values of all 
predefined EQUALS-names at the time the RESTORE command is given. That 
is, the values of all predefined names (see Appendix A, Predefined Names) 
are saved in the SAVE-file; therefore, when the RESTORE command is given, 
all operating parameters are restored to their values as saved in the 
SAVE-file. 

o User-defined EQUALS-names from the SAVE-file are added to the EQUALS-names 
already defined when the RESTORE command is given. 

o LOCATION-names from the SAVE-file are added to those already defined when 
the RESTORE command is given. If the files to which these names refer no 
longer exist, or if they have been rekeyed, then using such LOCATION-names 
may give unexpected results. 

o If the SAVE-file contains window information (i.e., if SAVE SESSION or 
SAVE ALL was used to create the SAVE-file), then when the RESTORE command 
is given, any editing windows and their edit block stacks are discarded. 
In addition, the editing window information from the SAVE-file is used to 
create a new editing window(s) and edit block stack(s). Again, if the 
files to which this window information refers no longer exist, or if they 
have been rekeyed, then the RESTORE command may give unexpected results. 

Related Commands: 

SAVE 



SAVE ConrmrTand 
Syntax: 

C AL[L] ] { TO } 

SAVE [ SETU[P] ] { ON } fid 
[ SESS[ION] ] C OVER } 

Parameters: 

fid is the fid of the file to save the requested context information in. 
ALL saves all of the context file information. 

SETUP saves the value of all EQUALS-names, KEYIN-names, and SYNONYM-names. 
It does not save the value of LOCATION-names or any window information. 
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SESSION saves the value of all LOCATION-names, as weLL as information about 
the windows currently on your terminal screen. For the editing windows, this 
includes the window dimensions, the files you are currently editing, the 
current locations of the cursor, and the entire edit block stacks (the files 
you edited previously), for each editing window. 

Descr ipt ion: 

The SAVE command directs 6Edit to save current context information in a file. 
The file created by the SAVE command is called a "SAVE file". The SAVE file 
can be used Later to restore the saved context using the RESTORE command (or 
using the file as the context file which is read when 6Edit is started, see 
Context Files). If you do not specify the type of information to be saved, 
all the current context file information is saved. 

If "TO fid" or "ON fid" is used, the file specified by fid must not yet exist; 
the SAVE command creates the file. If "OVER fid" is used, then the SAVE 
command replaces the file if it already exists, or creates it if it does not 
yet exist. 

The file created by a SAVE command is a special encoded "workspace" file, with 
file type "We". It cannot usefully be edited using EDIT or 6Edit, and should 
not be altered in any way by the user. 6Edit can detect most changes to the 
file, and will not restore an encoded context file which has been modified. 

Related Topics: 

RESTORE Command 
Context Files 



SHOW Command 

Syntax: 
SH[OW] option 
Parameters: 

option is one of the following: 

ST[RING] str ing_expression displays the string represented by 
str ingL_expression. 

KE[YINS] displays the keyin definitions. 

[EQ[UALS]] [name [TH[RU] nameZ]] displays one, some, or all EQUALS 
def i n i t ions . 
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LO[CATIONS] [name [TH[RU] name2]] displays one, some, or all LOCATIONS 
def ini t ions. 

SY[NONYMS] [name [TH[RU] nameZ]] displays one, some, or all SYNONYMS 
def init ions. 

[BL[OCK]] block_expression displays complete records selected by a block 
expression, preceded by the record key in an appropriate format. 

[WI[NDOWS]] displays window definitions. 

Descr ipt ion: 

The SHOW command is used for terminal display of string operands, the values 
of names created with assignment commands (KEYIN, EQUALS, LOCATION, and 
SYNONYM), and records within a selected block. 

The SHOW command displays its output through M$LO, which defaults to the 
command window. Unless the command is activated with <LF> (instead of a 
carriage return), the command window is first expanded to occupy the space 
used by the editing window and the IBEX window, and one additional read from 
the command window is forced after the display. With <LF>, the display is 
presented in the command window and the cursor returns immediately to the 
editing window. 

In SHOW displays of KEYIN definitions or EQUALS names for which different 
definitions exist for different windows, the window for which a definition 
applies is indicated in parentheses after the name, (edt) represents the 
first editing window, (cmd) represents the command window, (edn) represents 
the nth editing window. 

Example: 

SHOW STRING $KEY(ESC) I I* [36m' 

On a color ANSI-compatible terminal, changes the display to a light-blue 
color. 

SHOW STRING HEREII', ' I I $DATE(TY* ' LOCAL ' )<LF> 

displays the current file FID, record key, column, and date in the command 
window, without interrupting the editing window. 

SHOW SAUTOTAB 

displays the current setting of the SAUTOTAB EQUALS variable (predefined 
name) . 
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SHOW 'A' 

dispLays the next record in the current file that contains an "A". 
SHOW FILE :6EDIT_C0NTEXT REPEAT SELECT RECORD SELECT 'A' 
displays all records in the file :6EDIT_C0NTEXT that contain an "A". 
SHOW $N0T_C0PIED 

displays the records that were not included in a failed copy operation. 
SHOW LO $NOT_COPIED 

dispLays a block expression describing the records that were not included in a 
failed copy operation. 

SHOW SINSERT 

dispLays the current setting of the SINSERT EQUALS variable. If SINSERT is 
set to ON only in the command window, the display would be 
"$INSERT(cmd) ON". 

SHOW WINDOWS 

displays the current window definitions. 

SYNONYM Command 

Syntax: 

SY[NONYM] name [IS] fragment 
Parameters: 

name can be any character other than SCONTROL, SCOMMENT, semi-colon (;), or 
have a digit as the first character. 

fragment is any set of words, quoted strings, or special characters, up to 
the end of the command Line. 
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Descr ipt ion: 

The SYNONYM command assigns to name any fragment of a 6Edit command Line. It 
is used to create your own variations of the basic syntax. 

Because name can be either a normal name (which Looks Like a keyword) or a 
string of special characters (which Looks like an operator symbol)^ you can 
create your own syntax by defining name to be some series of already-defined 
names or symbols. 

The fragment parameter specifies any set of words, quoted strings, or special 
characters, up to the end of the command line. 

The following restrictions apply to the fragment parameter: 

o Quoted strings must be completely specified (that is, you cannot have 
unbalanced string delimiters in a fragment). 

o The command separator character semicolon (;) has no effect in a fragment 
when the SYNONYM command is processed. That is, it does not mark the end 
of the SYNONYM command; instead, it is included in a fragment. Later, 
when name is given in a command line, any semicolons included in the 
fragment (along with the other characters in a fragment) are recognized, 
and demarcate separate commands in the command Line. 

A semicolon appearing at the end of a command line normally indicates that 
the command is continued on the next line. However, this is not true when 
a SYNONYM command appears in the command line. As for the command 
separator, the trailing semicolon is included in the fragment. Later, 
when the SYNONYM name is given in a command Line, the trailing semicolon 
in a fragment is treated as a command separator, if more characters follow 
the SYNONYM name on the command Line, or as a command line continuation 
indicator, if no characters follow the SYNONYM name. 

o Other substitutions can be used in a fragment. Specifically, names 

defined with previous SYNONYM commands may appear. Substitutions for them 
take place when this SYNONYM command is processed and before the new value 
is assigned to name. Names defined with the EQUALS and LOCATION commands 
may also appear in a fragment; however, substitutions for them do not 
occur until name is used later in a command line. 

o The current SCOMMENT character is recognized in a fragment, and has its 
usual effect at the time the SYNONYM command is processed. 

o 6Edit does not recognize SCONTROL characters in quoted strings until the 
synonym is used. Then, only the current value of SCONTROL is 
acknowledged. Be careful when using SCONTROL functions in a fragment: do 
not change the value of SCONTROL, or unexpected results might occur. 
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Example: 

SYNONYM EP IS EDIT PREVIOUS 

makes EP a synonym for EDIT PREVIOUS. When EP is typed at the command prompt, 
6Edit wiLL perform the EDIT PREVIOUS command. 

SYNONYM - THRU 

renders the dash (-) a synonym for THRU. When you type <-> in a command, 
6Edit henceforth interprets it as the THRU keyword. 

Related Topics: 

Substitution 

TIME Connnnand 

Syntax: 
TIME 

Parameters: 
None 

Descr ipt ion: 

TIME displays the current time and date. The format of the display is: 

mmm dd 'yy hh:mm (month)(day)(year )(hours)(minutes) 

Example: 

TIME 

displays the current time and date. 

Related Commands: 

DATE 
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WINDOW Command 



Syntax' 

Form 1, for creating a new editing window: 

[ {PO[SITIONS]} ] 

NE[W] WI[NDOW] [ expr {LI[NES] } ] 
[ {PE[RCENT] } ] 

Form 2, for changing an existing editing window: 

[ {PO[SITIONS]} ] 

WI[NDOW] [window_num] [ expr {LI[NES] } ] 

[ {PE[RCENT] } ] 



Form 3, for switching to another editing window: 

{ NEXT } [ {PO[SITIONS]} ] 

{ PREV[IOUS] } WI[NDOW] [ expr {LI[NES3 } ] 

[ {PE[RCENT] } ] 



Form 4, for deleting an editing window: 
DE[LETE] WI[NDOW] [window_num] 
Parameters: 

expr is a 6Edit string expression which evaluates to a number. 

window__num is a 6Edit string expression between 1 and the number of editing 
windows. 

Descr ipt ion: 

The WINDOW command can be used to create a new editing window, change or 
remove an existing editing window, or to switch to another editing window. 
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o Creating a New Editing Window 

To create an editing window, form 1 of the WINDOW command is used: 

NEW WINDOW expr POSITIONS wiLL create a new window which is "expr" 
positions wide and the height of the editing window portion of the 
6Edit screen. The new window will be created at the right of the 
rightmost editing window. Not implemented for A03 version. 

NEW WINDOW expr LINES will create a new window which is "expr" 
Lines high and the width of the 6Edit screen. The new window wiLL be 
created at the bottom of the bottom editing window. 

NEW WINDOW expr PERCENT will create a new window which is "expr" 
percent of the size of the 6Edit screen, along the dimension of the 
window creation mode. The new window will be created at the bottom or 
right of the bottom or rightmost editing window. 

If expr is given but neither POSITIONS, LINES, nor PERCENT is given, then 
PERCENT is assumed. 

Examples: 

NE WI 

will create a new editing window in the current creation mode; if there 
are no editing windows yet or just one, a new vertical window will be 
created at the bottom of the current editing window. $WI_PERCENT will 
determine the window size. 

NE WI; FI XXX 

will create the new editing window, and will begin editing file "xxx" in 
the new window. 

o Changing or Removing an Editing Window 

To change the size of the current editing window, form 2 of the WINDOW 
command is used. 

To remove the current editing window, use: 
DELETE WINDOW 

The window will be deleted, removing it from the screen. The space it 
occupied will be given to the editing window above it or to its left. 
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If expr (given as either a number of positions, a number of Lines, or as a 
percentage of the screen size) specifies the entire editing window portion 
of the 6Edit screen (or anything Larger), then 6Edit assumes you want to 
remove aLL editing windows except the current one. Thus: 

WINDOW 100 PERCENT 

wiLL make the current editing window into the onLy one on the screen, 
temporariLy removing aLL others. 

0 Switching Between Editing Windows 

There are two ways to switch to a different editing window: using the 
WINDOW command, or by typing an activation character. 

In the command window, you can type form 3 of the WINDOW command: 

{ NEXT } 

{ PREV[IOUS] } WINDOW 

This wiLL move the cursor to the current fiLe pointer Location in the 
window to the "next" or "previous" editing window. NEXT means the window 
to the right or beLow the current window; PREVIOtJS means the window to the 
Left or above the current window. This movement "wraps" at the edges of 
the editing window portion of the 6Edit screen; for exampLe, typing 
"PREVIOLJS WINDOW" when the cursor is in the Left-most editing window wiLL 
move the cursor to the right-most editing window. 

ALSO in the command window, you can type form 2 of the WINDOW command 
specifying a window number but no size option: 

WINDOW 2 

This WiLL move the cursor directLy to the indicated editing window. 

If 6Edit is being run on-Line, the <CNTL-N> activation character can be 
used to move the cursor to the next editing window. "Wrapping" around the 
screen at the edges occurs as described above. 

Even if 6Edit is reading from the command window when <CNTL-N> is typed, 
the cursor wiLL be moved to the next editing window. 

ReLated Topics: 

MuLtipLe Editing Windows 
EQUALS Command 
KEYIN Command 
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String Expressions 



Str ing Express ions 

A string expression can specify either a character or a numeric value, 
depending on how it is used. Certain commands and string operators anticipate 
character operands. For them, an expression which evaluates to a numeric 
value is converted to a character string containing a decimal representation 
of the numeric value. If a command or string operator expects a numeric 
operand and you supply a string expression which evaluates to a character 
value, then 6Edit assumes that the string contains a decimal representation of 
a number, and tries to convert the string to a numeric value. If the string 
does not contain a reasonable decimal representation of a number, 6Edit 
rejects the expression and the command in which it is used. The maximum 
length of a string expression is 511 characters. 

String expressions consist of functions, operators, constants, and variables. 
In 6Edit (and IBEX) string expressions, constants are either decimal numbers 
or quoted strings. Variables are symbols whose values have been defined by 
6Edit EQUALS (and IBEX LET) commands, or by the processor itself (such as the 
6Edit predefined names and IBEX system variables). 

Most of the 6Edit's string operators and functions are also implemented by 
IBEX. The following tables list 6Edit's string operators and string 
functions. (For a complete description of the string functions, refer to 
Appendix B, Predefined String Functions.) 
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Table 4-1. String Functions 



C ADC 


i r i u U K v3 


a>LUL 




<r A r r T 


ttCTr\ Dcrc 
$r 1 y KcL d 


M A V 


e CI.I T T ru 

SoWi 1 tn 


SCMDVAR 


$FID_TYPE 


$MIN 


SSYSID 


SCNTL 


$FID_UGRANS 


$MOD 


STERM FEP 


SDATE 


$FLA6 


SMODE 


$TERM_LINE 


$DAY 


$HSET 


$NAME 


STERM PROFILE 


$DIR 


SINDEX 


SPRIV ACTIVE 


STERM SPEED 


$EOF 


SINPUT 


$PRIV_AUTH 


STIME 


$FID_ASN 


$KEY 


$REM 


SUPC 


$FID_EXIST 


SKEYIN 


SRERUN 


SVERIFY 


$FID_GRANS 


SLASTBATCH 


SSEARCH 


SVERSION 


$FID NGAVAL 


SLENGTH 


$SITE 


SWOO 



Table 4-2. String Operators 



& 


.AND. 


<= 


.LE. 


<? 


.CONTAINS. 


< 


.LT. 


1 1 
1 1 


!I .CONCAT. 


-? 


, MATCHES. 


/ 


.DIVIDED. 




.MINUS. 




.EQ. 




.NE. 


>= 


.GE. 




.NOT. 


> 


.GT. 


1 


.OR. 


? = 


.1MB. 


+ 


.PLUS. 


?> 


.IN. 


* 


.TIMES. 



Note that string operators can be typed as symbols, or words. If words are 
used, however, they must be enclosed by periods. 

The special characters used as string operators are not reserved for this use. 
You can use the SYNONYM command (see Section 3, 6Edit Commands) to assign a 
special character to some other 6Edit keyword or command. 

For example, the dash (-) is often interpreted to mean "through." To use the 
dash in this way, you would define it as a synonym for the 6Edit THRU keyword: 

SYNONYM - THRU 

After defining the dash to mean THRU, you cannot use it to mean subtract. 
Instead, use .MINUS, to perform subtraction functions, or define another 
synonym: 

SYNONYM .MINUS. 



String Expressions 



CE70-02 



After defining these two synonyms, you can use a dash (-) to mean THRU, and an 
underscore (_) to mean subtract. 

Example: 

Using the above synonyms, 
DI 5-10 

means display records 5 through 10. 
SIZE EQ 5_10 

means the name SIZE now has the value -5. 



Logical Operators 



Syntax: 

number {&I.AND.} number 
number {I I. OR.} number 
{- I .NOT.} number 

Parameters: 

number is a string expression. It evaluates to a logical value, and must 
consist of one or more numerals. 

Description: 

These operators compute Boolean values from their operands. All operands are 
assumed to represent logical values, that is, either a true value or a false 
value. All operands must be numeric; 6Edit interprets their values as: 

o True, if number is non-zero (either greater than zero or less than zero). 

o False, if number is exactly zero. 

The .AND. operator forms the logical conjunction of its two operands. The 
result is either one or zero, representing true or false respectively. The 
result is one if both operands are true. The result will be zero if either or 
both operands are false. 

The -OR. operator forms the Logical union of its two operands. The result is 
either one or zero, representing true or false respectively. The result is 
zero if both operands are false. The result is one if either or both operands 
are true. 



Str ing Expressions 

CE70-02 4-3 



The .NOT. operator forms the Logical inverse of its operand. The result is 
either one or zero, representing true or false respectively. The result is 
zero if the operand is true. The result is one if the operand is false. 



Relational Operators 



Syntax: 

str ing- 
str ing- 
str ing- 
str ing- 
str ing- 
str ing- 



{= I .EQ.} str ing-2 
{~=l .NE.} str ing-2 
{<! .LT.} string-2 
{<=I.LE.} string-2 
{>l .6T.} string-2 
{>=l .GE.} string-2 



Parameters: 

string-1 is a string expression. It evaluates to the operand to be 
compared. 

string-2 is a string expression. It represents the value to which string-1 

is compared. 

Descr ipt ion: 

These operators compare their two operands. 

If both operands are numeric, then a numeric comparison is performed (10 is 
equal to 010, 01 is less than 010). If either operand is not numeric, a 
character-by-character string comparison is performed. If one string is 
shorter than the other, 6Edit pads it with blanks. 

The result computed by each of these operators is a numeric operand: either 
1, indicating that the relation is true, or 0, indicating that the relation is 
false. 

The result of the .EQ. operator is true if the two strings are equal, false 
otherwise. 

The result of the .NE. operator is true if the two strings are unequal, false 
otherwise. 

The result of the .LT. operator is true if string-1 is less than string-2, 
false otherwise. 

The result of the .LE. operator is true if string-1 is less than or equal to 
string-2, false otherwise. 
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The result of the .6T. operator is true if string-1 is greater than string-2, 
false otherwise. 

The result of the .GE. operator is true if string-1 is greater than or equal 
to string-2, false otherwise. 



Wi Idcard Operators 



Syntax: 

string-1 {?=I.IMB.} string-2 
string-1 {=? I .MATCHES.} string-2 
string-1 n>I.IN.} string-2 
string-1 {<? I .CONTAINS.} string-2 

Parameters: 

string-1 is a string expression. It evaluates to the operand to be 
compared. 

string-2 is a string expression. It represents the value to which string-1 
is compared. 

Descr ipt ion: 

These operators compare their two operands, taking the wildcard function into 
account. 

Wildcard operators resemble relational operators, but allow one string to 
contain one or more "wildcard" characters, the question mark (?). A wildcard 
character (?) appearing in one string matches a sequence of any number of 
characters (including 0 characters) in the other string. For example: 

If the wildcarded string is 

'Product is ? stock' 
then it equals both of the following strings: 

'Product is in stock' 

'Product is out of stock' 

Note that the wildcard character (?) used by these operators appears 
differently than the SCONTROL-Quest ion Pattern function. (See Section 5, 
Block Expressions in 6Edit.) In the latter instance, the SCONTROL character 
is used, whereas for wildcard operators, the question mark is used alone. 
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Like the reLationaL operators, the result computed by each of these wildcard 
operators is a numeric operand: either 1, indicating that the relation is 
true, or 0, indicating that the relation is false. Unlike the relational 
operators, string-1 and string-2 are always treated as sequences of 
characters: a character-by-character string comparison is always performed. 

The .1MB. and .MATCHES, operators look for the complete match of a wiLdcarded 
string. The .IN. and .CONTAINS, operators look for a contained wildcarded 
str ing. 

The result of the .1MB. ("Is Matched By") operator, accounting for wildcard 
characters, is true if the two strings are equal, false otherwise. Question 
marks appearing in string-1 represent wildcard characters; however, question 
marks appearing in string-2 are given no special interpretation, they are 
taken at face value. 

The result of the .MATCHES, operator, accounting for wildcard characters, is 
true if the two strings are equal, false otherwise. Question marks appearing 
in string-2 represent wildcard characters; however, question marks appearing 
in string-1 are given no special interpretation, they are taken at face value. 

The result of the .IN. operator, accounting for wildcard characters, is true 
if string-1 is a substring of string-2, false otherwise. Question marks 
appearing in string-1 represent wildcard characters; however, question marks 
appearing in string-2 are given no special interpretation, they are taken at 
face value. 

The result of the .CONTAINS, operator, accounting for wildcard characters, is 
true if string-1 contains string-2 as a substring, false otherwise. Question 
marks appearing in string-2 represent wildcard characters; however, question 
marks appearing in string-1 are given no special interpretation, they are 
taken at face value. 



Arithmetic Operators 



Syntax: 

[number-1] {+I.PLUS.} number-2 
[number-1] {-I. MINUS.} number-2 
number-1 {* I. TIMES.} number-2 
number-1 {/ I .DIVIDED.} number-2 
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Parameters: 

number-1 and number-2 represent the operands to be combined. 
Description: 

These operators perform arithmetic functions with their operands. ALL 
operands must be numeric. 

The .PLUS, operator adds its two operands. If number-1 is omitted, the resuLt 
is number-2 itseLf. 

The .MINUS, operator subtracts number-2 from number-1, or, if number-1 is 
omitted, from zero. 

The .TIMES, operator muLtipLies its two operands. 
The .DIVIDED, operator divides number-1 by number-2. 

CONCATENATE Operator 

Syntax: 

string-1 {II or !! or .CONCAT.} string-2 
Parameters: 

string identifies the character or characters to be joined. 
Descr ipt ion: 

The .CONCAT. operator joins its two string operands into one string. 
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Section 5 

Block Expressions in 6Edit 



This section discusses the types of block expressions used in 6Edit, and 
explains them in context. 

Using Block Expressions 

6Edit editing commands work with "blocks" of data. A block can be an entire 
file, or any portion of a file. 

A "block expression" specifies a block in a file. As with other types of 
expressions, a block expression consists of block operands, which are combined 
by block operators to yield a result. The result of the evaluation of a block 
expression is itself a block operand. 

Block operands differ from operands in string expressions. They not only have 
values associated with them, they have locations as well. The "location" 
associated with a block operand is the location of a block within a file; the 
value of a block operand is the contents of the file at that location. 

Evaluation of block expressions also differs from evaluation of string 
expressions. The evaluation of block operands results in not only a value and 
a location, but a signal as well. This signal indicates the success or 
failure of the evaluation of the block operand. Continued evaluation of the 
block expression depends on the success or failure of the evaluation of each 
block operand in the block expression. 



Specifying User-Defined Blocic Operands 

In a block expression, you can use the basic block operands which are 
predefined by 6Edit, or you can define a block yourself and use it as a block 
operand. For example, you can define a group of three contiguous records as a 
block, then use this block as a block operand in a block expression. 

In fact, the result of any block expression is a "user-defined block." 
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By combining the basic block operands and other user-defined block operands 
with "block options" and "block operators," you can define a user-defined 
block to be any continguous set of data characters anywhere in any file. This 
is done generally as follows. 

After indicating the file in which the data characters reside, you use block 
operators and operands to move a file pointer through the file. The file 
pointer points to a single character in a record. Usually, you delimit a 
block by: 

1. Moving the file pointer to the first character of the block (the starting 
point); 



2. Typing the THRU keyword; 



3. Moving the file pointer to the character following the last character of 
the block (the ending point). 

Note that blocks need not start or end on record boundaries. 

Basically, a block expression specifies three things: 

o The "enclosing block." This is the file (or other block) in which the 
block being specified resides. If omitted, the edit block is used as the 
enclosing block. In commands, you can specify an enclosing block which is 
different than the edit block by explicitly naming the file (or other 
absolute block operand; see below) to use as the enclosing block for this 
block expression. 

The enclosing block limits the movement of the file pointer and hence the 
bounds of the block being specified by the block expression. The block 
being specified must lie completely within the bounds of the enclosing 
block. 



o The starting point of the block. If omitted and an enclosing block was 
specified explicitly, then the starting point of the block defaults to the 
start of the enclosing block; if omitted and no enclosing block was 
explicitly specified, then the starting point of the block defaults to the 
current location of the file pointer. 

When moving the file pointer to the desired starting point, you are not 
allowed to move it outside the bounds of the enclosing block. Attempts to 
do so will be rejected. 

o The ending point of the block. If omitted, the end of the last block 
operand given in the starting point specification is assumed; if the 
starting point was itself omitted, then the ending point of the block 
defaults to the end of the current selected block. 
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When moving the file pointer to the desired ending point, you are not 
allowed to move the file pointer outside the bounds of the enclosing 
block. Attempts to do so will be rejected. 

Block expressions allow you to specify these components in many different 
ways. For example, after specifying a starting point and an ending point for 
the block being defined, you can change either or both boundaries (ADJUST 
clause). This can be useful when you are specifying the block interactively, 
and you want to change the boundaries of the block being defined as you 
examine the data in the file. 

Also, you can specify a "repeated block." A repeated block is a block which 
is repeated throughout a file. It must not contain any absolute block 
operands. For example, you can define three records of a file to be a block; 
you can also repeat that block expression, thus defining each three-record 
group in the file to be a block. When a command includes a block expression 
which specifies a repeated block, then the command is repeated, once for each 
instance of the repeated block. In the example just given, the command which 
included the repeated block expression would be repeated, each time operating 
on a different three-record group in the file. 



Concepts 

This subsection describes the concepts necessary for a complete understanding 
of block expressions. 



Block Operands 

Operands in block expressions are usually blocks themselves. You build up the 
specification of a block by using the basic block operands predefined by 
6Edit: 

0 A f i le. 

o A string expression whose value is treated as a file. 

0 A previously-selected and named block. 

o The previous or next entry in the edit block stack. 

o A record in a file. 

o A data character in a record. 

o A string of data characters in a file which match a user-specified 
pattern string. 

Generally, you can combine any of the above basic blocks to specify your own 
block, no matter what the "shape" or location of the block. For instance, you 
can specify a block to be three records in a file, or to be two records in a 
file and the first twenty characters of the next record in the file. 
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There are two classes of block operands: absolute and relative. They are 
discussed in the following paragraphs. 



Absolute Block Operands 

An "absolute" block operand is one which has a specific location. The 
absolute block operands are: 

FILE fid 

STRING str ing_expression 

PREVIOUS 

NEXT 

locat ion_name 
record__key 

When evaluating an absolute block operand, the Location of the file pointer 
after evaluating the operand has absolutely nothing to do with the location of 
the file pointer before evaluating the operand. For instance, record 62 of 
file "ABC" is an absolute block operand; there is only one location specified 
by that block. 

o FILE specifies a file to be used as a block operand. A block expression 
can contain only one FILE operand, which must be the first block operand 
in the expression. 

o STRING specifies a string expression whose value is to be treated as a 

file, and used as a block operand. Usually the string expression value is 
treated as record 0 of a one-record file; however, by including the 
SCONTROL-Record function in the string expression, a multi-record "file" 
may be specified. 

Like FILE, STRING may be used only once in a block expression, and only as 
the first block operand in the expression. 

o PREVIOUS designates the previous edit block as a block operand. There may 
be only one PREVIOUS operand in a block expression, and it must be the 
first block operand in the expression. 

o NEXT designates the next edit block in the edit block stack as a block 

operand. There may be only one NEXT operand in a block expression, and it 
must be the first block operand in the expression. 

o The "locat ion__name" specifies a previously-specified and named block to be 
used as an absolute block operand. This allows you to define your own 
absolute block operands and give a name to them (with the LOCATION 
command); thereafter, that name can be used in other block expressions as 
an absolute block operand. 
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The Locat ion_names may be used more than once in block expressions; 
however, aLL Locat ion_names used in a block expression must specify blocks 
residing in the same file. If a locat ion_name is not the first operand in 
a block expression, then all locat ion_names in the expression must specify 
blocks residing in the same file as the current edit block. 

o A "record_key" identifies a specific record within the current enclosing 
block which is to be used as a block operand. 



Relative Blocic Dperands 

A "relative" block operand is a block which may be located anywhere in any 
file. For instance, a record as a block (with no record key) may be located 
anywhere in a file. A file is typically made up of many such records. 

The relative block operands are RECORD, POSITION, and pattern-string. 

Relative block operands are used to tell 6Edit in a relative way how to move 
the file pointer. The location of the file pointer after evaluating the 
operand is relative to the location of the file pointer before evaluating the 
operand. For example, assume that the file pointer is at position 21 of 
record 62 in file "ABC"; you can tell 6Edit to move forward five RECORD. In 
this use, RECORD is a relative block operand; its actual location is relative 
to the current location of the file pointer. No specific record key was 
given, only "direction" and "skip" block options ("forward" and "five" 
respect ively) . 

ALL the relative block operands specify a block located at or around the 
current file pointer Location. By preceding the operand with the SKIP option, 
you can move the file pointer forward or backward in units of the block 
operand; for example, SKIP moves by records with the RECORD operand, but by 
positions within a record when used with the POSITION operand, and by 
pattern-matches when used with the pattern-string operand. 

o RECORD specifies the record to which the file pointer points as the block 
operand. 

o POSITION specifies as the block operand the one data character to which 
the file pointer currently points. It may also be used to specify a 
position within the record to which the file pointer currently points. 

o "Pattern-string" is a string expression; its value is a pattern to search 
for within the enclosing block. If a match is found, the matching data in 
the enclosing block is the block operand specified by "pattern-string." 
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Block Options 

You can modify bLock operands with "block options." 

If a block operand is given without a particular option, 6Edit uses as the 
default the current value of the predefined name for that option. There is a 
specific predefined name for each option. The value assigned to these names, 
if any, is usually the keyword for the desired option (see the EQUALS 
command). If the predefined name for an option has no value and the option 
was not specified with a block operand, 6Edit uses a standard default. 

There are two kinds of block options: "evaluation options" and "processing 
options." 



Eva I uat i on Opt i ons 

The evaluation options tell 6Edit how to evaluate the block operand with which 
they are specified, that is, how to move the file pointer through the file 
looking for an instance of the block operand. 

In a command line, the evaluation options are typed before the block operand 
to which they apply. 

"Point" option "Direction" option "Skip" option 



ALL OF FORWARD SKIP 

BEGINNING OF BACKWARD 
END OF 

o The point option specifies to what point in the block operand the file 

pointer is to be moved. ALL OF moves the file pointer to either the start 
or the end of the block operand, as appropriate, and selects the entire 
block operand. BEGINNING OF always moves the file pointer to the 
beginning of the block operand. END OF always moves the file pointer to 
the end of the block operand. Both of the latter select only the end 
point of the operand. The default is SPOINT. 

o The direction option tells 6Edit in which direction the file pointer is to 
be moved from its current location, forward or backward. The default is 
SDIRECTION. 
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o The skip option specifies which instance of a relative block operand is to 
be located. For example, if you specify a skip option (with its skip 
count) with a pattern-string block operand, then 6Edit does not treat the 
first match of the pattern string as the block operand, but instead the 
"nth" match (where "n" is the skip count). The default is $SKIP. 



Processing Options 

The processing options give 6Edit additional instructions on how to process a 
block after evaluation. 

The processing options apply to the result of the evaluation of the entire 
block expression, not to just one operand in the expression. Therefore, in a 
command lin , the processing options are typed before or after the entire 
block expression. 

OPTION: "Protect" "Exist" "Structure" "Key increment" 



o The protect option controls modification of the contents of the block 
during editing. PROTECT prohibits any modification of the data in the 
block during the processing of the command which includes the block 
expression. DONT PROTECT explicitly allows modification. The default is 
SPROTECT. 

o The exist option performs a test on the file you are about to process. 
After locating the file specified by a block expression, 6Edit examines 
the exist option (if any) included in the block expression. NEW tells 
6Edit that this block evaluation succeeds only if the file does not exist, 
hence the file is created. OLD tells 6Edit that the block evaluation 
succeeds only if the file does exist. ANY creates the file if it does not 
exist, or uses it if it does exist. The default is SEXIST. 

o The structure option tells 6Edit how to treat the file in terms of record 
keys and insertion techniques. 

o The key increment option tells 6Edit how to generate new record keys when 
inserting records into a file. It is used on blocks which will be the 
destination of a copy or move operation. 6Edit inserts records into 
destination blocks; it needs to generate new record keys for these 
inserted records. BY tells 6Edit how to generate new record keys based on 
the existing record keys of records in the block. The default is $BY. 



PROTECT 
DONT PROTECT 



NEW 
OLD 
ANY 



EDITKEY 

STRINGKEY 

SEQUENTIAL 



BY 
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Evaluation of Block Operands 

The result of the evaluation of a block operand has three components: 
o A new "location" for the file pointer. 

o A "value," which is always the data in the file at the new location of the 
file pointer. 

o A "signal" — "success" or "failure" — indicating whether or not 6Edit 
succeeded in evaluating the block operand. 

Signals 

A block operand yields a "signal." The signal indicates the success or 
failure of the evaluation of the block operand. 

The evaluation of a block operand (as modified by any block options specified 
with it) fails in these four cases: 

o An absolute operand specifies a block which is located completely outside 
the boundaries of the current enclosing block. For example, if the 
enclosing block is records 50 through 100 of a file, a record key operand 
specifying record 200 will fail when evaluated. 

o A pattern-string operand fails when evaluated if 6Edit cannot find a match 
for the pattern string inside the boundaries of the current enclosing 
block. 

o A repeated block has already been evaluated the specified number of times. 

o The starting range for evaluation of the next instance of a repeated block 
is outside the boundaries of the enclosing block. 

Failure in evaluating a block operand is not considered an error. It is 
usually a perfectly normal occurrence, and controls evaluation of the block 
expression. For example, to replace all appearances of a string in a file 
with another string, you specify a repeated block to COPY OVER all matches of 
a pattern string. This repeated block causes the command which includes it 
(the COPY OVER command) to be repeated for each match of the pattern string. 
When 6Edit cannot find any more pattern string matches, evaluation of the 
pattern-string block operand fails, thus terminating processing of the 
command. This failure is intended, and is not an error. 
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Block Expression Components 
This subsection describes in 



detai L 



the components of a block expression. 



Generad Fornn of Stock Expressions 
General Form: 

[encLosing_block] [REPEAT] SELECT [movement] 

{THRU 1 ADJUST} [movement] [{THRU I ADJUST} [movement]]... 
[[REPEAT] SELECT [movement] 

{THRU I ADJUST} [movement] [{THRU I ADJUST} [movement]]...]... 



Parameters: 

encLosing_bLock is any block expression. An "encLosing_bLock" may be 
omitted; if it is, the current edit block is used as the enclosing block for 
the expression. 

REPEAT SELECT serves two purposes: it may be used to enclose block 
expressions, and/or to specify a repeated block. 

movement is a "movement expression": a list of block operands, possibly 
modified by evaluation options. A "movement expression" moves the file 
pointer to a new location. 

THRU tells 6Edit that the next movement (movement expression) moves the 
file pointer to the end of the block being specified. 

ADJUST tells 6Edit that the next movement (movement expression) moves the 
file pointer to the opposite end of the block being specified. 

Description: 

As described earlier, block expressions specify three things: the enclosing 
block, the beginning point of the block, and the ending point of the block. 

The first SELECT clause is needed only when "enclosing_block" is given, or 
when the SELECT clause specifies a repeated block. 

Each "SELECT ... {THRU I AD JUST} ... {THRU I AD JUST} ..." group specifies the 
beginning and ending points of a block; each such group except the last 
specifies the enclosing block for the next SELECT group. 
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Note that all components of a block expression are optional, but at least one 
component must be given. 



SELECT Clause 
Syntax: 

[REPEAT] SE[LECT] block__express ion 
Parameters: 

bLock_expression must not include absolute block operands. Only relative 
block operands may be included in "block__expression." 

Descr ipt ion: 

The SELECT clause is used for either or both of two purposes: to specify 
repeated blocks, and/or to enclose blocks. 

If REPEAT is given, then block_expression is a repeated block (see below). 



Repeated Bloclcs 

To specify a repeated block, precede the block expression with a REPEAT SELECT 
c lause. 

Including a repeated block expression in a command causes the entire command 
to be repeated until the end of the enclosing block is reached. On each 
repetition of the command, the block expression evaluates to successive 
blocks. 

6Edit continuously evaluates repeated block expressions. On the first 
evaluation, the file pointer starts at its current location. The 
block_expression should contain movement expressions which move the file 
pointer through the enclosing block, first to the beginning, and then to the 
end of the block being specified. 

On successive evaluations, the file pointer starts at the end of the block 
specified by this block_expression on the previous evaluation. The 
block_expression then moves the file pointer (relative to the end of the 
previously-found block) first to the beginning, and then to the end of the 
next block for block__expression. 
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Example: 



Assume you want to replace whatever appears between the words "the Piercy " 
and " we sold", with the word "novel". That is, the following strings in the 
file will be changed to "the Piercy novel we sold": 

the Piercy book we sold 

the Piercy picture we sold 

the Piercy novella on urban renewal we sold 

However, the string "the Atwood book we sold" does not change. 

To do this, specify a repeated block, searching for the given patterns to find 
the start and the end of the block to be replaced: 

COPY STRING 'novel' OVER REPEAT SELECT EO 'the Piercy ' THRU BO ' we sold' 

contains a REPEAT SELECT clause. This causes the COPY OVER command to be 
repeated as long as the block expression following SELECT can find a block in 
the file. The block expression is: 

EO 'the Piercy ' THRU BO ' we sold' 

specifying two patterns to be searched for. The block found by this block 
expression begins at the end of (EO) the next string in the file matching the 
first pattern, and ends at the beginning of (BO) the next string in the file 
matching the second pattern. When these two patterns are found, all data 
between them is replaced with the string 'novel*. 

After each replacement, 6Edit repeats the pattern search (because REPEAT was 
specified). Starting from the end of the found block (in this example, the 
beginning of " we sold"), 6Edit searches again for the first pattern ("the 
Piercy "). If it finds a match, 6Edit searches for the second pattern, and if 
it finds a match for that pattern, another replacement is made. Then, 6Edit 
repeats the evaluation of the block expression, searching for the first 
pattern again. 

This repetition continues until the end of the file (or other enclosing block) 
is reached in one of the pattern searches. 
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Enclosed Bloclcs 

An "enclosed block" is one which is entirely contained within another block. 
The outer block is called the "enclosing block"; the enclosed block is the 
block being specified, which is located entirely inside the enclosing block. 

To specify an enclosed block, follow the specification of the enclosing block 
with the SELECT clause, followed by the specification of the enclosed block. 
(If the edit block is the enclosing block, then the SELECT clause is not 
necessary, unless a repeated block is desired.) 

Enclosed blocks are useful when you want to limit the movement of the file 
pointer to some block smaller than the edit block. The edit block always 
limits all file pointer movement. 

Example: 

Assume you want to insert a string of characters "xxx" at the beginning of 
every record between records 10.0 and 50.0, inclusive. To do this, you type 
the following commands. 

COPY STRING 'xxx' 

AFTER 10 THRU 50 REPEAT SELECT RECORD SELECT BO RECORD 

The first command, COPY STRING 'xxx', sets up the source block for the copy 
operat ion. 

The AFTER command contains a complex block expression, including both enclosed 
blocks and repeated blocks: 

10 THRU 50 

First, the enclosing block is specified: the block comprising records 10.0 
through 50.0 inclusive in the current edit block. 

REPEAT SELECT RECORD 

is a repeated block expression, specifying a block for every record between 
10.0 through 50.0. A repeated block specification evaluates to several 
blocks; these blocks are enclosed within the enclosing block. In this case, 
the enclosing block is 10.0 through 50.0; the enclosed blocks will be each 
whole record which appears in the enclosing block. 
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SELECT BO RECORD 

specifies an enclosed block: an empty block at the start of each record. 
Note that each block specified in the previous step becomes the enclosing 
block for this step. 



Movement Expressions 
Syntax: 

[block_opt ions] block__operand 

Descr ipt ion: 

A "movement expression" is a sequence of block operands, optionally modified 
by block options. These tell 6Edit how to move the file pointer through the 
current enclosing block. 

In its simplest form, a movement expression is a list of block operands. In 
front of each block operand, you can give block options to be applied to that 
operand. 

Example: 

20.3 BACKWARD SKIP 30 RECORDS POSITION 18 

Three block operands compose this movement expression: the record key "20.3", 
"RECORDS", and "POSITION 18". The "RECORDS" operand is modified by two block 
options: "BACKWARD" and "SKIP 30". 

This expression causes 6Edit to move the file pointer to record 20.3, then 
back up 30 records in the file, and finally move the file pointer to position 
18 of that record. 



THRU Clause 
Syntax: 

{TH[RU] ITH[ROUGH]} [movement_expression] 
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Parameters: 



movement__express ion is a movement expression. 
Descr ipt ion: 

THRU telLs 6Edit that "movement_express ion" specifies the ending Location of 
the bLock being specified. Whenever THRU is seen, the current file pointer 
Location becomes the beginning of the bLock being specified. 

If "movement_express ion" is omitted, the block being specified becomes an 
empty block (containing zero data characters) located at the current file 
pointer Location. If "movement_express ion" is included, it should move the 
file pointer to the desired ending location for the block being specified. 

Example: 

DE 20.1 

deletes the entire record 20.1. 
DE 20.1 THRU 25 

deletes all records between and including 20.1 and 25. 
5 THRU 

specifies a block beginning and ending at the start of record 5.0. This is an 
empty block. 

THRU 6 

specifies a block beginning at the current file pointer Location, and ending 
at the start of record 6.0. 



ADXIST Clause 
Syntax: 

AD[JUST] [movement__expression] 
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Parameters: 



movement__express ion is a movement expression. 
Description: 

ADJUST allows you to change either boundary location of the block being 
specified. It tells 6Edit that "movement_express ion" specifies the Location 
of the boundary opposite to the one currently being specified. 

The following example illustrates a command sequence, using the ADJUST clause. 
The vertical format suggests successive returns to the command window after 
each function. 
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Records in file INVENTORY: 




40 
41 
42 






• 

48 
49 






Commands 


in command window: 




41 


moves the cursor to the beginning of record 41. 




TH 


begins block selection. 




48 


selected block is 41 TH 48; cursor is at the beginning of 
record 49. 


ADJUST 


moves the cursor back to the beginning of record 
it does not change the selected block. 




BA SK 1 


RE moves the cursor to beginning of record 40. The 
block is now beginning of 40 thru end of 48. 


selected 


ADJUST 


moves the cursor back to the end of the selected 
beginning of 49. 


block: 


DE THAT 


deletes beginning of 40 thru end of 48. 





Figure 5-1. Using the ADJUST Clause 



ADJUST is most useful after a THRU clause. When 6Edit sees the THRU clause, 
its movement expression moves the file pointer to the end of the block being 
specified. When the first ADJUST following THRU is given, 6Edit remembers the 
current file pointer location as the ending Location of the block being 
specified, and moves the file pointer to the beginning location of the block. 
The movement expression following this first ADJUST then changes the beginning 
location of the block, by moving the file pointer (from its initial location 
at the beginning of the block) to a new beginning location. 
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ADJUST Clause 



The second ADJUST after THRU acts simiLarLy. 6Edit remembers the current file 
pointer Location as the beginning Location of the bLock, and moves the fiLe 
pointer to the ending Location of the bLock; the movement expression foL Lowing 
the ADJUST changes the ending Location of the bLock. 

Each successive ADJUST repeats this process. Odd-numbered ADJUSTS after THRU 
(i.e., the first, third, fifth, etc.) change the beginning Location of the 
bLock being specified; even-numbered ADJUSTS after a THRU change the ending 
Location of the bLock being specified. 

At any time in a bLock expression, you can use THRU. This cLause renders the 
current fiLe pointer Location the beginning Location of the bLock being 
specified; the movement expression foLLowing THRU aLways modifies the ending 
Location of the bLock. 



Movement Expression Components 

The foLLowing paragraphs describe in detaiL the bLock operands and options 
used in movement expressions. 



ALL OF Option 

Syntax: 

{AL[L] OF I AO} bLock_operand 
Parameters: 

bLock_operand may be any absoLute or reLative bLock operand, possibLy 
modified by other bLock options (onLy one of the three "point" options — ALL 
OF, BEGINNING OF, and END OF — may be used with a bLock__operand) . 

Descr ipt ion: 

ALL OF teLLs 6Edit to move the fiLe pointer to either the beginning or the end 
of "bLock_operand," depending on the context: 

o In the first movement expression of a SELECT cLause or in an ADJUST 
cLause, this construct wiLL move the fiLe pointer to the beginning of 
bLock_operand. 

o In the Last operand of a THRU cLause, this construct wiLL move the fiLe 
pointer to the end of bLock_operand. 
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Example: 

DELETE AO 5 THRU AO 6 

deletes the records between record 5.0 and 6.0, including all of records 5.0 
and 6.0. 

BACKWARD Option 

Syntax: 

BA[CKWARD] relat i ve_block 
Parameters: 

relat ive_block must be a relative block operand. 
Descr ipt ion: 

BACKWARD tells 6Edit in which direction in the file to move the file pointer 
when searching for a relative block operand. 

Relat ive_b lock must be a record, position, or pattern-string operand; 6Edit 
moves the file pointer backward accordingly. 

Examples: 

BACKWARD SKIP 8 RECORDS 

moves the file pointer backward in the file, skipping over 8 records. 
BACKWARD SKIP 28 POSITIONS 

moves the file pointer backward in the file, skipping over 28 positions 
(characters in records). 

BACKWARD 'abc' 

moves the file pointer backward in the file, searching for the string "abc" in 
the file. 
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BEGINNING OF Option 



Syntax: 

{BE[GINNING] OF I BO} bLock_operand 
Parameters: 

bLock_operand may be any absolute or relative block operand, possibly 
modified by other block options (only one of the three "point" options — ALL 
OF, BEGINNING OF, and END OF — may be used with a block_operand) . 

Descr ipt ion: 

BEGINNING OF tells 6Edit to move the file pointer to the beginning of 
block_operand. For instance, if block_operand was a block comprising three 
records, BEGINNING OF tells 6Edit to move the file pointer to the first 
character of the first of the three records. 

Example: 

DELETE BO 5 THRU BO 6 

deletes the records between record 5.0 and 6.0, including record 5.0. 
However, record 6.0 will not be affected. 



BY Option 

Syntax: 

block_expression BY edit_key 
Parameters: 

edit_key is a CP-6 edit key, that is, a string of 1 to 8 digits; if a 
decimal point is included in the string, there may be 0 to 3 digits to the 
right of the decimal point. 
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Descr ipt ion: 

BY specifies a value to be used when 6Edit generates new record keys for a 
keyed file. 

BY may be included in block expressions which specify destination block 
operands only; this only includes the operands of the AFTER and OVER commands. 

If block_expression resides in an edit-keyed file and 6Edit must insert new 
records in that file, 6Edit must generate new record keys for the new records. 
6Edit does this by adding the value of edit_key to the record key of the last 
existing record in front of the location in the file into which 6Edit is 
inserting records. Therefore, for edit-keyed files, edit__key must evaluate to 
a numeric operand whose value is between 0 and 99999.999, inclusive. If the 
generated key is greater than or equal to an existing key in the file, then 
6Edit discontinues the operation, and displays an error message. 



Example: 

CO FILE ACCTS_PAYABLE 1 TH 50 AF FILE ACCTS__RECEIVABLE 1024 BY .1 

If the BY option is not specified with a block operand, the current value of 
$BY is used as the record key increment. 

CO FILE *1 OVER NEW FILE *2 BY 1 

If the BY option is used for a block expression that also creates a new edit 
block as in the example above, that key increment value overrides the value in 
the $BY predefined name for the rest of the life of that edit block. 



END OF Option 

Syntax: 

{EN[D] OFIEO} block_operand 
Parameters: 

block_operand may be any absolute or relative block operand, possibly 
modified by other block options (only one of the three "point" options — ALL 
OF, BEGINNING OF, and END OF — may be used with a bLock_operand) . 
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Descr ipt ion: 



END OF teLLs 6Edit to move the file pointer to the end of bLock_operand. For 
instance, if bLock,_operand was a block comprising three records, END OF teLLs 
6Edit to move the fiLe pointer to the first character of the record foLLowing 
the three-record block. 



FILE Block Operand 

Syntax: 

C { NE[W] } { ST[RING]KEY } ] 

[ { OL[D] } { SECQUENTIAL] } ] FI[LE] fid 

[ { AN[Y] } { ED[IT]KEY } ] 

Parameters: 

fid is a CP-6 file identifier and must refer to a file. 
Descr ipt ion: 

The FILE operand specifies a certain file to be the enclosing block for the 
rest of the block expression. 

NEW tells 6Edit that fid must specify a file that does not exist. 6Edit will 
create the file as an edit-keyed file. SFILETYPE specifies the value to use 
for the type attribute of the new file. 

OLD tells 6Edit that fid must specify a file which currently exists. 

ANY tells 6Edit to create the specified file if it does not already exist. 

STRINGKEY tells 6Edit that the file to be created or modified must have keys, 
and that the keys are presumed to be textual names. Insertion of new records 
is permitted only if the key of the new record is explicitly specified. 
Record keys are specified using the KEY option. 

SEQUENTIAL tells 6Edit that the file to be created or modified must be 
unkeyed. Records may be added or deleted only at the end of the file. Record 
keys are sequential record numbers starting at 1. 

EDITKEY tells 6Edit that the file to be created or modified must have standard 
(3-byte) edit keys. Records may be inserted or deleted anywhere. Record keys 
must evaluate to 3-place decimal numbers up to 99999.999. 

The FILE block operand may not be modified by the following block options: 
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SKIP 

FORWARD 

BACKWARD 

The default "point" option for the FILE block operand is ALL OF, regardless of 
the current value of SPOINT. To begin editing a file at its end, use two 
commands: EDIT FILE fid; EO CURR . 

Example: 

COPY REPEAT SELECT SKIP 2 'The %? we sold' AFTER ANY FILE SALES 

creates the file SALES if it does not already exist, then searches forward in 
the current edit block for matches of the pattern "The %? we sold", and copies 
every other such match to the end of the SALES file starting with the second 
match. After searching to the end of the current edit block, 6Edit displays 
the SALES file in the editing window. 



FORWARD Option 
Syntax: 

FO[RWARD] relat ive_block 
Parameters: 

relat ive_block must be a relative block operand. 
Descr ipt ion: 

FORWARD tells 6Edit in which direction in the file to move the file pointer 
when searching for a relative block operand. 

Relat ive_block must be a record, position, or pattern-string operand; 6Edit 
moves the file pointer forward in the file (toward the end of the file) 
accordingly. 
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Syntax: 
Locat ion_name 
Parameters: 

Locat ion_name is a name. It may be either a predefined name (SLEFTOVER, 
$NOT_COPIED, HERE, THAT, or CURRENT), or a name you created whose value has 
previously been set with the LOCATION command. 

Descr ipt ion: 

A Locat ion_name can be used as an absolute block operand. This operand 
specifies a block which you specified and named earlier (or a block predefined 
by 6Edit itself). 

If Locat ion_name is the first operand of a block expression, then the file to 
which the name refers becomes the enclosing block for the rest of the block 
expression. If locat ion_name is not the first operand of a block expression, 
then it must refer to the same file as the enclosing block for the block 
expression. 

If the first block operand in a block expression is not one of the following 
block operands, then the edit block is used as the enclosing block for the 
rest of the block expression: 

PREVIOUS 
NEXT 
FILE 
STRING 

locat ion_name 

The locat ion_name operand may not be modified by the following block options: 

SKIP 

FORWARD 
BACKWARD 

The default "point" option for the names as block operands is ALL OF. 
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Spec i a I I ocat i Qn_names 

Several predefined names are reserved as special locat ion_names . They can be 
used in block expressions just like any other Locat ion_name, however, their 
value is determined by 6Edit (you cannot explicitly assign a value to these 
names). As for all other names, they may be entered in either upper-, mixed-, 
or lower-case. 

CURRENT 

The CURRENT predefined name always specifies the current edit block. The edit 
block is set by the EDIT command, the NEXT and PREVIOUS block operands, and 
implicitly whenever the enclosing block for a block expression is in a 
different file than the current edit block. The name CURRENT can be 
abbreviated to CURR. 

THAT 

The THAT predefined name always specifies the current selected block. The 
selected block is the block of data operated upon by the most recent editing 
command. 

HERE 

The HERE predefined name always specifies an empty block. This block is 
located at the current file pointer location. 

SLEFTOVER 

The SLEFTOVER predefined name contains some portion of a single record of the 
source data that does not fit into the destination block on a copy operation. 
Once you have corrected the problem that caused the incomplete copy, you may 
use SLEFTOVER as the source for another copy operation. 

$NOT_COPIED 

The SNOT__COPIED predefined name contains the location of some portion of the 
source data that does not fit into the destination block on a copy operation. 
Once you have corrected the problem that caused the incomplete copy, you may 
use SNOT_COPIED (which is a location name but does not hold the actual data) 
to perform another copy operation. 
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Examples: 



BO CURRENT 

moves the file pointer to the beginning of the current edit block (usually to 
the beginning of the file being edited). 

COPY THAT AFTER EO CURRENT 

contains two special locat ion_names as block operands: "THAT" and "CURRENT". 
Assuming the user has just selected a block, this COPY command copies that 
selected block to the end of the current edit block (usually to the end of the 
file being edited). 

COPY L AFTER HERE 

contains two names as block operands: "L" and "HERE". "L" is assumed to be a 
name created by the user with the LOCATION command, so that it names the 
location of a block (either in the current file or in any other file). This 
COPY command copies the block at location "L" to the current file pointer 
(cursor) position. 



Pattern-String Block Operand 

Syntax: 

{ PA[TTERN] str ing_expression I 'string' } 
Parameters: 

str ing_expression is a string expression which may be empty, (i.e., have no 
characters in its value). It specifies the pattern to search for in the file. 

string is a quoted string of characters which may be empty (i.e., ''). It 
specifies the pattern to search for in the file. If a quote character is to 
be included in string as part of the pattern to search for, then it must 
appear twice (e.g. 'don"t' searches for the word "don't"). 

Descr ipt ion: 

The pattern-string block operand finds a match for a pattern string 

( str ing__expression) in the enclosing block. The file pointer is moved to the 

matching data. 

The search for a match is bounded by the enclosing block for the block 
expression. If a match is not found within the enclosing block, then 6Edit 
will not move the file pointer from its starting location. 
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The search for a match of the pattern string ignores record boundaries in the 
enclosing block up to the limit specified by the $MATCH_LIMIT predefined name. 

The SCASE predefined name tells 6Edit how to treat alphabetic characters while 
searching for a match of the pattern string. If the current value of SCASE is 
ON (or any number >= 1), then file data characters are compared directly with 
characters from the pattern string. If the current value of SCASE is OFF (or 
any number <= 0), then Lower-case alphabetic characters in both the file data 
characters and the pattern string are treated as though they were upper-case. 

The only difference between the two forms of this block operand (use of string 
expression vs. 'string') is that the str ing_expression form allows you to 
combine strings using the concatenate operator, and/or use EQUALS-names to 
specify the pattern to search for. The 'string' form is easier to type, 
however, and can be used when the facilities of string expressions (see 
Section 4, String Expressions) are not needed. 

The default "point", "direction", and "skip" options for the pattern-string 
operand are SPOINT, SDIRECTION, and SSKIP, respectively. SKIP 0 tests for a 
match at the current cursor location. SKIP 1 moves forward/backward one 
position before beginning the search. 



Syntax of the Pattern Str i ng 

The str ing_express ion designates the pattern string. It tells 6Edit how to 
identify a "match" in the enclosing block. 

Most characters in the pattern string specify values which must appear in 
identical form and identical order in the enclosing block in order to yield a 
"match." For instance, if you say: 

abc 

then the only match possible is a string of three characters in the enclosing 
block, whose values are the lowercase ASCII characters a, b, and c, in that 
order. An exception to this "exact match" rule is made if the SCASE 
predefined name is OFF when the pattern search is made. (See Appendix A, 
Predefined Names.) 

The pattern string is specified by a string expression. This allows 
non-displayable character values to be included in the string (using the 
SCONTROL-Value function). 

Several of the SCONTROL functions have special meaning when they appear in the 
pattern string. Also, some additional SCONTROL functions are supported only 
when they appear in pattern strings; these are called "pattern functions." 
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SQDNTRDL-Beg i nn i ng of Match Pattern Funct i on 



Function Identifier: B 

This pattern function should appear only once in a pattern string. It 
specifies what point in the matching file data is to be considered the 
beginning of the match. If SCONTROL-Beginning of Match is not included in a 
pattern string, the first character of the matching file data is considered 
the beginning of the match. 

For example, assuming the SCONTROL character is percent (%): 

COPY STRING 'memo' OVER REPEAT SELECT PATTERN 'my %Breport' 

searches for the string 'my report' in the file. However, the beginning of 
the match is the "r" of "report": the block found and replaced by this 
command will be the word "report", but only if it appears after the word "my 



$CDNTRDL~End of Match Pattern Function 
Function Identifier: E 

This pattern function should appear only once in a pattern string. It 
specifies what point in the matching file data is to be considered the end of 
the match. If $CONTROL-End of Match is not included in a pattern string, the 
character immediately following the matching file data is considered the end 
of the match. 

For example, assuming the SCONTROL character is percent (%): 

CO STRING 'memo' OVER REPEAT SELECT PATTERN 'report%Es from this office' 

searches for the string 'reports from this office' in the file. However, the 

end of the match is the "s" of "reports": the block replaced by this command 

will be the word "report", but only if it appears before the string "s from 
this office". 
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SCONTRDL-Quest i on Pattern Funct i on 
Function Identifier: ? (question mark). 

No parameters may be included in the $CONTROL-Quest ion function. 

The $CONTROL-Quest ion function specifies that a sequence of any number of 
characters in the enclosing block (including 0) is considered a match. 

For example, consider the following pattern string, assuming the SCONTROL 
character is the percent symbol (%). 

abcde%?f ghi jkl 

This pattern string matches the following strings in the enclosing block: 

abcde1234fghi jkl 
abcde' tf ghi jkl 
abcdef ghi jkl 
abcde fghijkl 

Multiple instances of the SCONTROL-Quest ion function are permitted. For 
examp le, 

COPY STRING •from%W(2)any%W(1)to' OVER ' to%?any%?f rom' 

substitutes the COPY string for the OVER string for each string that matches 
the pattern of the OVER string, retaining the portions of the pattern string 
represent by %?s. Up to 10 instances of %W are permitted in a COPY or MOVE 
string; any number of %?s are permitted in the pattern string. 



$CDNTRDL-Va I ue Function in the Pattern String 
Function Identifier: V 

If the SCONTROL-Value function appears in the pattern string, it may include 
one or two parameters. Assuming the SCONTROL character is the percent symbol 
(%): 

o '%V()' - If no parameters are included, a character in the enclosing block 
whose ASCII code is zero is considered a match. This is identical to 
%V(0). 

o '%V(m)' - If one parameter is included, it must be a decimal number; a 
character in the enclosing block whose ASCII code equals the number is 
considered a match. 
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0 '%V(m,)' - If one parameter is included, it must be a decimal number. If 
a comma follows it, a character in the enclosing block whose ASCII code 
equals or is greater than the number is considered a match. 

o '%V(m,n)' - If two parameters are included, they must be decimal numbers. 
The first specifies a minimum value, the second a maximum value. A 
character in the enclosing block whose ASCII code is between the two 
values, or equal to either, is considered a match. 

o '%V(,n)' - If the second parameter is included but not the first, it must 
be a decimal number, and it must be preceded by a comma. A character in 
the enclosing block whose ASCII code is Less than or equal to the number 
is considered a match. For example: 

DELETE REPEAT SELECT '%V(,31)' 

Searches forward in the file for ASCII control characters, and deletes any 
it finds. The ASCII control characters have decimal codes in the range 0 
to 31. The pattern '%V(,31)' matches any single character whose ASCII 
decimal code is in that range. 

$CDNTROL-lUi I dcard Pattern Function 
Function Identifier: W 

The $CONTROL-Wi Idcard function is similar to the $CONTROL-Quest ion function 
(%?), except that it allows restrictions on the length of the string. 
Assuming the SCONTROL character is the percent symbol (%), the wildcard 
function is used in the following form: 

%W(min,max) 

The min and max parameters are the minimum and maximum Lengths, respectively, 
of the wildcard string and are always numbers which represent character 
positions. Both parameters or a single parameter may be included. 

%W is most logically used between two specific strings. For example: 

DISPLAY 'from%W(A,10)any' 

finds the next occurrence of "from" followed by "any" at Least A positions 
Later, but not more than 10 positions later in the enclosing block. 

DISPLAY 'from%W(A,)any' 

finds the next occurrence of "from" followed by "any" at least four positions 
later in the enclosing block, with no restriction on the maximum number of 
positions within the block. 
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DISPLAY 'from%W(,10)any' 



finds the next occurrence of "from" foL Lowed by "any" not more than 10 
positions Later in the encLosing bLock. There is no restriction here on the 
minimum number of positions after which "any" shouLd foLLow "from". 



POSITION Block Operand 
Syntax: 

PO[SITION[S]] [number ] 
[NU[MBER] str ing_expression] 

Parameters: 

number is a decimaL number between 1 and 2048, incLusive. 

str ing_express ion is a string expression. It must evaluate to a number 
between 1 and 2048, incLusive. 

Descr ipt ion: 

This block operand actually has two forms, with different effects. 
Skipping Over Existing Positions 

The first form of the position operand moves the file pointer over existing 
positions in records: 

P0[SITI0N[S]] 

moves the file pointer forward or backward in the current Edit Block some 
number of positions. The SKIP block option is used to specify the number of 
positions to move; if no SKIP option is used, 6Edit will move the file pointer 
by the number of positions in the SSKIP predefined name. 

This form of the position operand only specifies existing positions in 
records; it will not extend a record. This means the following: 

0 If the file pointer is at the beginning of a record when a BACKWARD 

POSITION expression is given, it moves to the end~of-record boundary of 
the previous record in the enclosing block. 
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o If the file pointer is in the Last position of a record when a FORWARD 
POSITION expression is given, it moves to the end-of-record boundary of 
that record. From the end-of-record boundary of a record, this form of 
the position block operand moves the fiLe pointer either (for BACKWARD) to 
the Last position of that record, or (for FORWARD) to the first position 
of the next record. 



Moving To a Specific Position In a Record 

The second form of the position operand includes a position number: 

PO[SITION] { number I NU[MBER] str ing__express ion } 

moves the file pointer to the specified position in the current record. If 
the current record is too short, it is lengthened (the value of the $PAD 
predefined name is appended to the record repeatedly until the record is Long 
enough) . 

The position to move to can be specified either as a number, or as a string 
expression. Position numbers range from 1 to 2048. To move the file pointer 
to the first position of a record, use "POSITION 1". 

The second form of the position operand may not be modified by the following 
block options: 

SKIP 

FORWARD 

BACKWARD 

The default "point" option for the second form of the position operand is 
SPOINT. 

Examples: 

SKIP 5 POSITIONS 

moves the file pointer forward five positions. If this moves the file pointer 
beyond the end of the current record, then the file pointer moves to the 
beginning of the next record, and continues movement from there. 

BACKWARD SKIP 3 POSITIONS 

moves the file pointer backward five positions. If the file pointer starts 
out less than five positions from the beginning of the record, it moves to the 
end of the previous record and continues movement from there. 

POSITION 28 
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moves the file pointer to position 28 of the current record. If the current 
record is shorter than 28 characters Long, it is extended to 28 characters, 
using the value of the $PAD predefined name (usually a space character) to 
extend the record. 

POSITION NUMBER MYTAB .MINUS. 8 

subtracts 8 from the current value of the user-created name MYTAB, and uses 
the result as the position number in the current record to move the file 
pointer to. If the current record is too short, it is extended. 



PROTECT Option 

Syntax: 

[DONT] PR[OTECT] b lock_express ion 
Parameters: 

b lock_express ion must begin with a FILE block operand. 
Descr ipt ion: 

When not preceded by DONT, PROTECT tells 6Edit that its block_express ion is to 
be protected from any changes. The block_express ion may not be altered or 
deleted, and no new records may be added. 

DONT PROTECT tells 6Edit to allow modification of the block. 

When specifying the edit block in the EDIT command, giving the PROTECT option 
to the block expression will essentially provide read-only access to the file 
as Long as that file is the current edit block. 

If an attempt is made to alter a PROTECTed block, 6Edit will reject the 
attempt and issue a beep at the terminal to inform the user of the attempted 
violation. 
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RECORD Block Operand 



Syntax: 
RE[CORD[S]] 
Descr ipt ion: 

RECORD is a relative block operand. It specifies a block whose starting point 
is POSITION 1 of a record and whose ending point is POSITION 1 of the next 
record (i.e., the end-of-record boundary is included in the block). 

When searching for this operand, the search for the starting point of the 
RECORD aims in the direction specified by any FORWARD or BACKWARD options for 
this operand; however, once the starting point is found, RECORD always 
specifies the record from that starting point forward to the end-of-record 
boundary, including that end-of-record boundary. 

The default "point", "direction", and "skip" options for the record operand 
are SPOINT, SDIRECTION, and $SKIP, respectively. SKIP 0 specifies the entire 
record that the cursor is positioned in. SKIP 1 specifies the next/previous 
(forward/backward) record. 

Examples: 

SKIP 20 RECORDS 

moves the file pointer forward in the file, skipping over 20 records. 
DELETE RECORD 

deletes the entire record in which the file pointer currently lies. 

COPY RECORD AFTER L 

copies the record in which the file pointer currently lies to the location 
named "L", where "L" is assumed to be a name created by the user with the 
LOCATION command. 
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Syntax: 



{ numeric_key I KEY str ing_express ion } 



Parameters: 



numer ic_key 



is either: 



o A string of 1 to 9 digits; a decimal point (period) may appear in the 
string such that there are 0-3 digits to the right of the decimal point 
and not more than 5 to the left. 

0 A string of 1 to 9 digits with no decimal point for sequential files. 



Descr ipt ion: 

A record key may be used as an absolute block operand. 6Edit moves the file 
pointer to the specified record in the enclosing block. 

If an ed it-keyed file is being used^ numer ic_key must be a number between 0 
and 99999.999; a decimal point (period) may appear in the string, with 0 to 3 
digits to the right of the decimal point. The numeric_key is interpreted as 
the actual record key of the record which is the block operand represented by 
numer ic_key. Note that this record key need not actually exist in the file; 
if the specified record does not exist, then numeric_key represents an empty 
block at the specified record key. In any case, the record key must be within 
the range of record keys of the current enclosing block. 

If a non-keyed (consecutive) file is being used, numer ic_key must be a string 
of 1 to 9 digits with no decimal point. It is interpreted as the record 
number within the file of the record which is the block operand represented by 
numer ic_key. The record number must be within the range of record numbers of 
the current enclosing block. 

The record key operand may not be modified by the following block options: 



str ing_expression 



specifies the key to be used for a string-keyed file. 



SKIP 

FORWARD 

BACKWARD 



The default "point" option for the record key operand is SPOINT. 
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Examples: 



48 

moves the file pointer to the record with key "48", when using an edit-keyed 
file. In a consecutive or unit-record file, specifying a numeric key moves 
the file pointer to the 48th record in the file. 

COPY 52.1 AFTER HERE 

copies the record with key "52.1" to the current file pointer (cursor) 
location. This command can only be used in an edit-keyed file, because the 
record key contains a decimal point. 

COPY ST 'NEW RECORD%R' AFTER KEY 'HELLO' 

creates a new record at "HELLO" in a string-keyed file. 



SKIP Option 
Syntax: 

SK[IP] number relat ive_block 
Parameters: 

number is a string expression. It must evaluate to a number which is 
greater than or equal to zero. 

relat ive_block must be a relative block operand. 
Descr ipt ion: 

The SKIP option tells 6Edit to repeat the relative movement specified by 
relat ive_block some number of times. The number parameter specifies the 
"repeat count." 

Remember, movement of the file pointer is limited to the bounds of the 
enclosing block. If you specify SKIP 10 RECORDS, but fewer than ten records 
remain in the enclosing block, the file pointer moves only to the end of the 
enclosing block. 

If the repeat count evaluates to zero, then 6Edit assumes that the current 
location of the file pointer lies within the bounds of the destination block. 
For example, if the file pointer is currently at position 10 of a record, then 
END OF SKIP 0 RECORDS moves it to the end of that same record. 
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Example: 

SKIP 10 RECORDS 

6Edit moves the file pointer 10 records. 



STRING Block Operand 
Syntax: 

ST[RING] str ing_expression 
Parameters: 

str ing_express ion is any string expression. It may include 
SCONTROL-Record, $CONTROL-Va lue, $CONTROL-Wi Idcard, and SCONTROL-Quest ion 
f unct ions . 

Descr ipt ion: 

Any string specified as a string expression can be included in a block 
expression as a block operand. 

The string value of the string expression is treated as a file; it becomes the 
enclosing block for the rest of the block expression. 

The STRING operand must stand alone; you may not select a block within the 
value of the string expression, using the usual block operands. The string is 
usually treated just like a one-record consecutive file; however, by including 
the SCONTROL-Record function in the string expression, you can create a 
multi-record file. 

Example: 

COPY STRING 'novels and Literary criticism' OVER REPEAT SELECT 'books' 

searches forward in the file for any matches of the pattern "books", and 
replaces them with the string "novels and literary criticism". 

COPY STRING '7o\^i2) %?• OVER '%? %?' 

switches the current word in the file with the next one. 
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When used in a string block operand, the $CONTROL-Wi Ldcard function must have 
exactly one parameter whose value is greater than zero. When the operand is 
eventually used by an AFTER or OVER command, the $CONTROL-Wi ldcard function is 
replaced by the string that matched a SCONTROL-Quest ion or $CONTROL-Wi Ldcard 
function in a pattern string for the command. The parameter specifies which 
particular SCONTROL-Quest ion or $CONTROL-Wi ldcard function in the pattern is 
to be substituted, counting from the beginning of the pattern string at one. 
For example, a $CONTROL-Wi ldcard function with a parameter value of 3 would be 
replaced by the string that matched the second occurrence of "%?" in the 
pattern string "begin%?mid1%W(5,10)mid2%?end". If the parameter exceeds the 
number of wildcard strings in the pattern, the function is ignored. 

The SCONTROL-Quest ion function, which permits no parameters, can also be used 
in a string block operand, and is exactly equivalent to a SCONTROL-Wi ldcard 
function with a parameter value of one. 

A maximum of ten combined $CONTROL-Wi Ldcard and SCONTROL-Quest ion functions 
may be used in any string block operand. 
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Appendix A 
Predefined Names 



This appendix Lists aLL the names predefined in 6Edit, and describes their 
values. 



Using Predefined Names 

Predefined names serve several purposes: 

o They provide a shorthand notation for certain commonly-used values. Some 
of these values are constants, and some are changed by 6Edit internally. 

o They allow you to give 6Edit certain operating values, and allow you to 
request that 6Edit perform certain functions. This method of telling 
6Edit what to do is used only for those functions which do not change 
often. Thus, 6Edit equips you to control many small details. 

You refer to these names by using 6Edit's substitution facility. You use most 
predefined names just like user-defined names. 

Predefined names differ from user-defined names in two respects: 

o You cannot assign values to some of the predefined names in the usual way, 
that is, with the assignment commands. Of those predefined names which 
cannot be assigned a value with the assignment commands, some have 
constant values, and 6Edit assigns new values to others internally. 

o Of the predefined names to which you can assign a value with the 
assignment commands, most can only be assigned values by specific 
assignment commands. This is because different assignment commands assign 
different types of values to names. The legal assignment command for each 
predefined name is Listed in the names' descriptions below. If you try to 
use the wrong command to assign a value to a particular name, 6Edit will 
reject the command. 

Table A-1 classifies the names predefined in 6Edit. 



Predefined Names 

CE70-02 A-1 



U:>irig Predefined Names 





Table A-1. 


Predefined Name Classifications 


Category 


Names 






Constant 


Values Provided by 6Edit 






ANY 


bU 


OLD 




AO 


DONT_PROTECT 


ON 




BACKWARD 


EO 


PROTECT 




BIN10 


FORWARD 


STRING 




BINHLF 


NEW 






BIN521 


OFF 




Values Set by 6Edit 








SCONTEXT 


$RECORDS_INSERTED 


SFILERECORDS 




SMATCHES 


SSITES * 


SFILETYPE 




$RECORDS_DELETED 


SFILEORG 






* SFILETYPE can 


also be used to set the 


file type of files 




being edited. 






Locat ion 


Names Set By 6Edit 








SLEFTOVER 


THAT 






$NOT_COPIED 


HERE 






CURRENT 






Terminal 


Control 








SAUTOTAB 


$HSCR0LL__MAR6IN 


SSCROLL 




$END__MARK 


SINSERT 


STEXTEDIT 




$EZ_APPEND 


$INTR0_1 


SVSCROLL 




SHSALL 


$1NTR0_2 


$VSCR0LL_MAR6IN 




SHSCROLL 


SRECORDWRAP 


SWORDWRAP 
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Table A-1. Predefined Name Classifications (cont) 


Category Names 


Session Control 






SINITIALIZE 


SRESTORE 




Window Control 






SCOMMAND 
$MAX_COMMAND 


SMIN^COnrlAND 
SSCREEN 


$WI_dORDER 
$WI_PERCENT 


Record Control 






$BY 

$KEY_GENERATION 
$MAX_RECORD 


SrIIN_RECORD 

SPAD 

SREKEY 


$STRIP_BLANKS 


Block Expression Defaults 






SDIRECTION 
SEXIST 


SPOINT 
SPROTECT 


SSKIP 


Pattern Searching 






SCASE 

$MATCH_LIM1T 






Lexical Characters 






SCOMMENT 
SCONTROL 
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Predefined Names 

The foLLowing table describes the 6Edit predefined names. 



Table A-2. Predefined Names 



Name Assignment Command and Description 



SAUTOTAB 

EQUALS a number between 0 and 254, inclusive. 
The number assigned to this name designates the "autotab 
position." A value greater than 1 implements automatic tabbing. 
Henceforth, the system always begins new records at the autotab 
position. To discontinue automatic tabbing, set SAUTOTAB to 0 or 
1. Initially, SAUTOTAB is set to 0. 

Note that you can also use "Escape Tab" to control automatic 
tabbing. Move the cursor to the desired autotab position, and 
type <ESC> <TAB>. To discontinue tabbing, move the cursor to the 
beginning of the record, and type <ESC> <TAB>. If STEXTEDIT is 
set to ON, then any attempt to move into a record (old or new) in 
a position to the left of the autotab causes an autotab. 



SBY 

EQUALS an edit key from 0 to 65.534. 

The number assigned to this name is the default key increment for 
new records. The default is 10.0. SBY is set and displayed as an 
edit key. An edit key is a valid component of a string 
expression, but cannot be combined with other component values. 



SCASE 

EQUALS ON or OFF. 

This name tells 6Edit how to handle alphabetic case in pattern 
comparison. If SCASE equals ON, then data bytes must equal 
pattern bytes to be considered a match. If SCASE equals OFF, then 
data bytes must either equal pattern bytes, or if alphabetic, 
equal the pattern byte when converted to the opposite case, to be 
considered a match. Initially, SCASE is set ON. 
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Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



SCOMMAND 

EQUALS ON or OFF. 

This name controls which window 6Edit reads. If SCOMMAND EQUALS 
OFF (the initial setting), 6Edit reads from the editing window. 
If SCOMMAND EQUALS ON, 6Edit reads from the command window. 

If you want to type several commands in succession, setting 
SCOMMAND to ON ahead of time eliminates repeatedly telling 6Edit 
to move the cursor to the command window. When you finish typing 
the series of commands, set SCOMMAND to OFF. 6Edit then resumes 
its normal operation. 



SCOMMENT 

EQUALS one or two characters. 

The character assigned to this name is used to mark the beginning 
of commentary in command lines. When this character appears in a 
command line but outside of a literal string, 6Edit ignores 
characters up to the next appearance of the SCOMMENT value, or up 
to the end of the command line. Characters between the SCOMMENT 
value are assumed to be commentary (arbitrary text meaningful only 
to you, not to 6Edit). Initially, the value of SCOMMENT is the 
quotation mark character (**). 

See Section 1, Overview of 6Edit, for restrictions on the 
character assigned to SCOMMENT and a description of the SCOMMENT 
character's function. 



SCONTEXT 

(You cannot assign a value directly.) 

This variable is a read-only value that returns the fid of the 
file used as the 6Edit context file. 
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Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



SCONTROL 

EQUALS one or two characters. 

Use the character(s) assigned to this name for certain control 
functions. If you wish to include the character itself in command 
lines or string literals, you must enter it twice in succession. 
You can effectively disable all SCONTROL functions by assigning an 
empty string to SCONTROL. Initially, the value of SCONTROL is the 
percent character (%). 

See Section 1, Overview of 6Edit, for restrictions on the 
character assigned to SCONTROL and for a description of the 
SCONTROL character's function. 



SDIRECTION 

EQUALS FORWARD or BACKWARD. 

This name specifies the default direction in the file in which 
pattern searching and the SKIP option in block expressions are to 
proceed. The initial value is FORWARD. 



SEND_MARK 

EQUALS a character string. 

The string assigned to this name defines a line of text to be 
displayed at end-of-file in the editing window. The initial value 
is a blank string (no display). The maximum length of the string 
is 80 characters. Any characters can be used; 0 characters or all 
blanks turns off an existing display. For example: 

SEND_MARK EQ 'File Ends Here' 

defines "File Ends Here" as the end-of-file marker. 

SEND_MARK EQ ' ' 

resets the marker to blank. 
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Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



SEXIST 

EQUALS OLD, NEW, or ANY. 

This name controls the default existence specification for files. 
SEXIST can be set to suit your particular usage of 6Edit. For 
example, if most of your usage of 6Edit is to build new files, 
setting SEXIST to NEW allows you to open a file with EDIT FILE 
filename instead of EDIT NEW FILE filename. Conversely, if most 
of the files you edit already exist, you could set SEXIST to OLD 
(which is the default value). If you work with an equal number of 
existing and new files, setting SEXIST to ANY eliminates the need 
for either the OLD or NEW keyword with EDIT FILE. 



SEZ_APPEND 

EQUALS ON or OFF. 

This name controls what is needed to extend (insert a blank Line 
at the end of) a file in the editing window. When SEZ_APPEND is 
set to ON, any attempt (such as a carriage return) to position the 
cursor to column 1 of the line below the Last record in the file 
will extend the file. When this feature is OFF, the last record 
in the file must not be empty for the file to be extended. The 
default is OFF. 



SFILEORG 

(You cannot assign a value directly.) 

This variable is a read-only value that returns the file 
organization of the file currently being edited (corresponding to 
the CURR location variable). 



SFILERECORDS 

(You cannot assign a value directly.) 

This variable is a read-only value that returns the number of 
records in the file currently being edited (corresponding to the 
CURR location variable). 
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Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



SFILETYPE 

EQUALS a 2-character string. 

The characters assigned to this name are used to change the file 
type for the current file, if it is changeable, and to set the 
default for any NEW FILEs created thereafter. (The current file 
is the file being edited [corresponding to the CURR location 
variable].) This variable may also be used to return the file 
type of the file currently being edited. Note that the default 
for NEW FILES may not be the same as the value displayed by 
SHOW SFILETYPE, since that command always displays the current 
file's type. DELETE WINDOW can be used to obtain access to the 
default value or to set the default without changing the current 
f i Le. 



SHSALL 

EQUALS ON or OFF. 

This name controls how lines are to be scrolled when horizontal 
scrolling is in effect. When SHSALL is ON, all the lines of a 
screen editing window are scrolled when a horizontal shift occurs. 
A value of OFF specifies to scroll only the record containing the 
cursor. The default is OFF. 



SHSCROLL 

EQUALS a number between 0 and half the screen width, inclusive. 
The number assigned to this name specifies how many columns to 
scroll the editing window when trying to move the cursor into a 
horizontal scrolling margin. Initially, SHSCROLL is 0. 

If SHSCROLL is greater than 0, that is, if horizontal scrolling is 
enabled, 6Edit scrolls the the editing window horizontally so that 
the character on which the cursor Lies is at the center of the 
editing window. 
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Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



$HSCR0LL_MAR6IN 

EQUALS a number between 0 and half the screen width, inclusive. 
The number assigned to this name specifies the number of columns 
in the horizontal scrolling margins. A designated number of 
columns represents these margins at the right and left of the 
editing window. 

Initially, $HSCR0LL__MAR6IN is set to 0; there are no horizontal 
scrolling margins, and horizontal scrolling is disabled. Setting 
$HSCR0LL_MAR6IN to a particular number of columns forces t he 
window to scroll horizontally when the cursor reaches the 
designated column, for example the fourth column from the left or 
right edge of the screen when $HSCROLL__MARGIN is set to 4. 



SINITIALIZE 

EQUALS a string expression consisting of 6Edit commands separated 
by the SCONTROL-record function. 

The commands assigned to this name are interpreted immediately 
following restoration of the context file at startup, thus 
allowing "active" commands such as SHOW or IBEX commands to be 
included in saved context files. Note that any $CONTROL-f unct ions 
in the commands other than those that separate the commands must 
use the $CONTROL-l iteral function to express the SCONTROL 
identifier (e.g., the command SHOW STRING •%V(33)A' would be 
specified for use in SINITIALIZE as 'SH STRING "%%V(33)A'". 

At startup, until the first editing command is given, 6Edit 
remains in serial mode (SSCREEN EQ 0), using the window set in 
M$6E (the default is ME, which uses UC01). So, until the first 
editing command that needs to build an editing window, any 
operations that affect the building of windows will continue to 
have an effect when the windows are finally built. For example, 
SINITIALIZE can be used to move the IBEX window to the bottom of 
the screen by setting it to 

•ILDEV UC98,P0SITI0N=B0TT0M,WL=1%R!ADJUST MS6E UC01 ' 

The second command (lADJUST MS6E UC01) tells 6Edit to use all the 

rest of the screen for editing, instead of its default, which is 

"all-but-the-top-line". 
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Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



SINSERT 

EQUALS ON or OFF. 

This name controls the insertion mode. Initially, the insertion 
mode is disabled by its initial setting (SINSERT EQUALS OFF). In 
this case, the characters typed replace the characters beneath the 
cursor, unless the cursor is at the end of the "insertion window" 
established with the Escape > or Escape J functions. When the 
insertion mode is enabled (SINSERT EQUALS ON), characters typed 
are always inserted at the cursor location; they never replace 
characters at the cursor. 

Note that the insertion mode is also enabled with the Escape ' 
function, and disabled with either the Escape M or Escape 0 
f unct ion. 



$INTR0_1 

EQUALS one or two tokens. The first may be a $KE¥ function. The 
second, if present, must be a character. 

The characters assigned to this name represent the primary 
introducer for KEYIN names (IMP functions). Initially, 6Edit uses 
the escape character <ESC> as the primary introducer. 



$INTR0_2 

EQUALS one or two tokens. The first may be a $KEY function. The 
second, if present, must be a character. 

The characters assigned to this name represent the secondary 
introducer for KEYIN names (IMP functions). Initially, 6Edit 
assumes no secondary introducer. If your KEYIN names use a 
secondary introducer, you must tell 6Edit (by setting SINTR0__2) 
before you use the KEYIN command. 
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Table A- 


-2. Predefined Names (cont) 


Name 


Ass ignment 


Command 


and Description 


$KEY_ 


_6ENERATI0N 







EQUALS BIN10, BINHLF, BIN521, or STRING. 

This name specifies how the FEP is to generate keys for new 
records inserted by means other than 6Edit's COPY or MOVE 
commands. If $KEY_GENERATION is set to BIN10 (the default), the 
key increment is divided by 10 repeatedly to find a usable 
increment. For the 6Edit default key increment of 10, inserted 
records would be separated by one of 10.000, 1.000, .100, .010, or 
.001 whichever works first. If $KEY_GENERATION is set to BINHLF, 
the key increment is halved repeatedly. For the key increment of 
10, the inserted records would be separated by 10.000, 5.000, 
2.500, 1.250, .625, etc. If $KEY_GENERATION is set to BIN521, the 
key increment is divided by 5, 2.5, and 2, and is then repeated. 
For the key increment of 10, the inserted records would be 
separated by 10.000, 5.000, 2.000, 1.000, .500, .200, .100, etc. 
If $KEY_GENERATION is set to STRING, insertion of new records is 
not permitted. STRING overrides any specification for 
string-keyed files. 

In general, the BINIO default may permit inserting a larger number 
of records in the same spot than would BINHLF or BIN521. Those 
values may be useful for inserting one or two records at a time 
and will tend to have a more even distribution of key numbers, but 
with more fractional keys. 



SLEFTOVER 

(You cannot assign value directly.) 

Whenever the source data for a copy operation does not fit into 
the destination block and SREKEY does not permit automatic 
rekeying, some portion of a single record of the source data may 
be saved as the value of the SLEFTOVER name. (6Edit does this 
internally when such an error occurs.) 6Edit tells you that it 
has stored some of the source data in SLEFTOVER. Once you have 
corrected the original problem, you may use SLEFTOVER as the 
source for another copy operation. 

When such an error occurs, either SLEFTOVER or SNOT_COPIED, or 
both, may be set. If SLEFTOVER is set, the data contained therein 
no longer remains in the file. If SNOT_COPIED is set, it simply 
refers to the location of the data that remains in the file. 
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Table A- 


■2. Predefined Names (cont) 


Name Assignment 


Command 


and Description 


$MATCH_L1MIT 













EQUALS a number . 

The vaLue assigned to this name specifies the maximum number of 
records which the match of a pattern expression can span. 
InitiaLLy, the value of $MATCH_L1MIT is 1; the entire pattern 
expression must match data residing in, at most, one record. If, 
for example, you were to set $MATCH_LIMIT to three, then all 
pattern expressions may match up to a three record span anywhere 
in the enclosing block. 

$MATCH_LIMIT limits any SCONTROL pattern-match function except 
SCONTROL-Record; $MATCH_LIMIT applies independently to each 
pattern substring between any SCONTROL-Record functions. 

When $MATCH_LIM1T is greater than 1, adjacent strings may match 
the pattern even if the strings span a record boundary. For 
instance, if the pattern is "reports from this office" and the 
file contains these strings split between two records: 

reports from 

this office 

then the occurrence in the file is considered a match, even though 
the pattern string contains a blank between "from" and "the", 
while the occurrence in the file contains only a record boundary 
there. 

For example, consider the following pattern string: 

'abc%?def ' 
If, when this is evaluated: 

$MATCH_L1MIT = 1 - Both "abc" and "def" must be found in the same 
record for a match to be found. 

$MATCH__LIM1T = 5 - "abc" must match in one record or two adjacent 
ones, and "def" must match in one record or two adjacent ones; 
however, there may be up to three records between the "a" record 
and the "f" record, so that the entire match spans five records. 
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Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



SMATCHES 

(You cannot assign value directly.) 

After each pattern search, 6Edit assigns a value to SMATCHES. 
This value represents the number of matches found for patterns in 
this evaluation of the block expression. Note that if a block 
expression contains more than one pattern operand, the value 
assigned to SMATCHES will be the sum of the matches found for both 
patterns. 



$MAX_COMMAND 

EQUALS a number. 

This name tells 6Edit how large to expand the command window when 
it displays messages (i.e. error or HELP messages). The number 
assigned to this name is the number of Lines on the terminal 
screen of the largest command window. The minimum value is 1; the 
maximum value is the height (in lines) of your terminal screen. 
Initially, SMAX_COMMAND is set to approximately half the height of 
the terminal screen. 



$MAX_RECORD 

EQUALS a number between 0 and 2048, inclusive. 

The value of this name is the maximum length, in bytes, of records 
written to files in 6Edit. If you change a record, and its length 
is greater than $MAX_RECORD, 6Edit truncates bytes from the end of 
the record so that it is $MAX_RECORD bytes Long. Initially, 
SMAX RECORD is set to 2048. 



SMIN__COMMAND 

EQUALS a number. 

This name tells 6Edit how small to diminish the size of the 
command window when you type commands, or when you are editing in 
the editing window. The number assigned to this name is the 
number of Lines in the smallest command window. The minimum value 
is 0; the maximum value is the height (in lines) of your terminal 
screen. Initially, $MIN_COMMAND is set to 2. 
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Table A- 


-2. Predefined Names (cont) 


Name Assignment 


Command 


and Description 


$MIN_RECORD 













Equals a number between 0 and 2048, inclusive. 

The value of this name is the minimum length, in bytes, of records 
written to files by 6Edit. If you change a record, and its length 
is less than $MIN_RECORD, 6Edit appends the value of the $PAD name 
to the record repeatedly, until it is $MIN_RECORD bytes long. 
Initially, $MIN_RECORD is set to 1. In this case, all records 
will be at least 1 byte long. 



$NOT_COPIED 

(You cannot assign value directly.) 

When the source data for a copy operation does not fit into the 
destination block, the location of some portion of the source data 
may be saved as the $NOT_COPIED name. (6Edit does this internally 
when such an error occurs.) $NOT_COPIED is a location name; it 
does not hold the actual data, but rather remembers the location 
of that part of the source block that was not copied to the 
destination due to error. 6Edit tells you when it has saved the 
locations of some of the source data in $NOT_COPIED. Once you 
correct the original problem, you may use $NOT_COPIED as the 
source for another copy operation. 

When such an error occurs, either SLEFTOVER or $N0T_C0P1ED, or 
both, may be set. If SLEFTOVER is set, the data contained therein 
no longer remains in the file. If $NOT_COPIED is set, it simply 
refers to the location of the data that remains in the file. 



SPAD 

EQUALS a character string. 

The value of this name is used to "pad" records which are shorter 
than the minimum specified by $MIN_RECORD. The minimum length of 
the value of SPAD is 1; the maximum length is 100. Initially, 
SPAD is set to a single space character. 
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Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



SPOINT 

EQUALS AO, BO, or EO 

This name specifies the default file position option for block 
expressions. AO (ALL OF, the default) causes the entire block to 
be selected. For example, a SELECT clause may move the cursor to 
the beginning of the block; END OF THAT would move it to the other 
end. BO (BEGINNING OF) causes only the beginning of the block to 
be selected; EO (END OF) causes only the end of the block to be 
selected. 

Note: SPOINT must not be set to EO for commands such as SHOW 
which select records by key, since EO RE is actually the beginning 
of the record following the desired one. 



SPROTECT 

EQUALS PROTECT or DONT_PROTECT 

This name controls the default protect status for files. SPROTECT 
can be set to suit your particular usage of 6Edit. For example, 
if you usually just read files without updating them (and want 
them protected), setting SPROTECT to PROTECT allows you to open a 
file with EDIT FILE filename instead of EDIT PROTECT FILE 
filename. Conversely, if you usually update files rather than 
just read them, setting SPROTECT to DONT_PROTECT (the default) 
allows you to open a file with EDIT FILE filename instead of EDIT 
DONT PROTECT FILE filename. 



$RECORDS_DELETED 

(You cannot assign value directly.) 

After each DELETE, OVER, or MOVE command, 6Edit assigns a value to 
SRECORDS_DELETED. This value represents the number of records 
deleted from the file by the command. Note that only entire 
records are counted; if only a portion of a record is deleted, it 
will not be included in the SRECORDS DELETED value. 
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Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



$RECORDS_INSERTED 

(You cannot assign value directly.) 

Following each AFTER or OVER command, 6Edit assigns a value to 
$RECORDS_INSERTED. This value represents the number of new 
records inserted into the file by the command. 



SRECORDWRAP 

EQUALS ON or OFF. 

This name controls the record wrap mode. Initially, the record 
wrap mode is disabled (SRECORDWRAP EQUALS OFF). In this case, any 
attempt to move the cursor beyond the ends of a record is ignored. 
When the record wrap mode is enabled (SRECORDWRAP EQUALS ON), the 
actions of following input editing functions are modified when the 
cursor is in the editing window. 

<ESC> <D> or <CNTL-H> 

(BS) 

If the cursor is at the first position of a record, it will 
move to just beyond the Last position of the previous 
record. 

<ESC> <C> or <CNTL-R> 

(DC2) 

If the cursor is beyond the end of a record, it will move 
to the first position of the next record. 

<ESC> <V> 

The search for the character typed after the <V> is not 
limited to the current record; however, it is limited to 
the records currently displayed in the editing window. 

<CNTL-W> 

(ETB) 

Moves to the next or previous word in the record or, if 
necessary, in the next or previous record. 
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Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



SREKEY 

EQUALS a number between 0 and 1000. 

The value of this name controls automatic rekeying of the file. 
If SREKEY is set to zero, 6Edit never automatically rekeys the 
file. If SREKEY is greater than zero, 6Edit tries to rekey as 
small a range up to its value in first the forward direction and 
then backwards as will permit the rekeyed records plus the 
inserted ones to be separated by the current increment value (from 
a BY clause in the command, or the $BY predefined name). If 
neither direction is successful, the entire file is rekeyed 
instead. (No attempt is made to find a combination of forward and 
backward records.) Sometimes, if the number of records involved 
is small, a smaller increment is used. The initial value is 100. 



SRESTORE 

EQUALS a character string. 

The string assigned to this name is an IBEX command. The IBEX 
command should not begin with an exclamation character (!). When 
6Edit exits, the current value of SRESTORE is passed to IBEX to 
execute. Usually, this IBEX command causes your normal terminal 
environment to be restored. IBEX commands used frequently are the 
IMP command, to process an IMP source or object file, and the XEQ 
command, to perform several functions. If SRESTORE has no value 
assigned to it, (e.g., SRESTORE EQUALS ''), then no such action is 
taken when 6Edit exits. 



SSCREEN 

EQUALS ON, OFF, or an integer. 

This name controls the size of the editing screen. Setting 
SSCREEN to 0 (OFF) requests serial editing by removing from the 
screen all editing windows. At startup, 6Edit sets SSCREEN OFF if 
the user is operating in batch mode or if the user's terminal 
profile indicates that screen editing is impossible. For an 
online CRT user running with SSCREEN OFF, setting SSCREEN to ON 
(or 1) restores the terminal to screen editing with editing 
windows in the same proportions as before. The size of the IBEX 
window can be increased (from 1 line) by setting SSCREEN. 
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Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



See Section 2, Serial Editing, for more information. If screen 
editing is not possible, SSCREEN may only be set to 0. 



SSCROLL 

EQUALS ON or OFF. 

This name controls scrolling in the command window. The default 
is ON. With scrolling on, consecutive entries in the command 
window are scrolled upward. With scrolling off, the asterisk (★) 
prompt remains at the top of the command window; consecutive 
entries are cleared when they reach the editing line. OFF is 
particularly useful on terminals where scrolling windows that do 
not extend to the bottom of the screen are awkward. 



SSITES 

(You cannot assign value directly.) 

After each command, oEdit assigns a value to SSITES. This value 
represents the number of blocks found during evaluation of the 
command. If the command did not include the REPEAT keyword, the 
SSITES will be set to either 0 or 1; only if REPEAT is used will 
SSITES be greater than 1. 



SSKIP 

EQUALS a number from 0 to 131071. 

This name specifies the number of times to repeat some relative 
movement of the file pointer within the specified block. The 
value assigned to SSKIP is used if no SKIP option is present in 
the PATTERN, POSITION, or RECORD block operands. The default is 
zero. 
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Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



$STRIP_BLANKS 

EQUALS ON or OFF. 

This name controls the stripping of trailing blanks from records 
written by 6Edit. If you change a record and $STRIP_BLANKS is set 
to ON, any space characters at the end of the record (which are 
not followed by any non-space characters) are removed from the 
record. Initially, $STRIP_BLANKS is set ON. 



$TEXTEDIT 

EQUALS ON or OFF. 

This name controls the spacing between words when joining or 
splitting text lines. With STEXTEDIT ON, a blank space is 
automatically added between words (the last word of the first line 
and the first word of the next line) when joining two lines. When 
splitting a line at the blank space before a word, the blank is 
automatically removed so that the new (next) line starts with the 
word, not the blank. The default is OFF. 



SVSCROLL 

EQUALS a number between 0 and the length of the screen, inclusive. 
The number assigned to this name specifies how many lines to 
scroll the editing window when trying to move the cursor into a 
vertical scrolling margin. 

When you reset SVSCROLL to 0, 6Edit scrolls the editing window so 
that the record in which the cursor lies is at the center of the 
editing window. Initially, SVSCROLL is set to 0. 



$VSCROLL_MARGIN 

EQUALS a number between 0 and half the length of the screen, 
inclusive. 

The number assigned to this name specifies the number of lines in 



CE70-02 



Predefined Names 



A-19 



Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



the vertical scrolling margins. A designated number of lines 
represents these margins at the top and bottom of the editing 
window. When you try to move the cursor into one of these 
margins, the window scrolls in the opposite direction; the cursor 
will not remain in the vertical scrolling margin. 

Setting $VSCROLL_MARGIN to a particular number of lines forces the 
window to scroll when the cursor reaches the designated line, for 
example the sixth line from the top or the bottom when 
$VSCROLL__MARGIN is set to 6. Initially, $VSCROLL_MARGIN is set to 
approximately 25% of the height of the editing window. 



$WI_BORDER 

EQUALS any single character. 

This name specifies the character used for the border that divides 
the command and editing windows. The hyphen (-) is the default. 
$WI_BORDER should be used in a context file, or set before any 
editing commands are used in a 6Edit session. If set to a null 
string (''), no border is used. This is useful with $nIN_COnMAND 
EQ 0, which then allows the entire screen to be used for editing. 
(If a PC is being used, this also lets the PC Terminal Facility 
save lines that scroll off the top in its history buffer.) 



$WI_PERCENT 

EQUALS a number from 1 to 99. 

The value assigned to this name is used in creation of windows. 
Rather than specifying the size of the new window to create, this 
name specifies the percentage of space remaining in the old 
window. For example, to create three even-sized windows in a 
21-line editing space using the LINES option, "NE WI;NE WI LI 
14;NE WI LI 7" would be used (presuming that no editing windows 
existed previously). Using the PERCENT option, "NE WI;NE WI 67;NE 
WI 33" would be used; but using the defaults, "$WI__PERCENT EQ 
33;NE WI;NE WI;NE WI" would suffice. The default for $WI_PERCENT 
is 50. 
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Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



SWORDWRAP 

EQUALS a number between 0 and 25A, inclusive. 
The number assigned to this name specifies the right margin for 
the "wordwrap mode." A value greater than 11 implements the 
wordwrap mode. The wordwrap mode removes a word which crosses the 
right margin from its original record, and replaces it at the 
beginning of a newly- inserted record. To discontinue the wordwrap 
mode, set SWORDWRAP to any value between 0 and 11. 

Note that you can also use the Escape " function to control the 
wordwrap mode. Move the cursor to the intended right margin, and 
type <ESC> <^>. To discontinue this wordwrap mode, repeat this 
sequence, positioning the cursor at the beginning of the record. 

The wordwrap mode allows you to enter textual material without 
concern with line length. As you type the text, 6Edit only allows 
you to type as far as the right margin. When you cross that 
margin, the system automatically begins a new record. If a word 
crosses the right margin, it moves that word to the new record 
also. You may thus type without ever touching the Return key. 
Initially, the SWORDWRAP mode is disabled. 



ANY 



(You cannot assign value.) 

This is a predefined constant; the value is always 3. 



AO 

(You cannot assign value.) 

This is a predefined constant; the value is always 1. 



BACKWARD 



(You cannot assign value.) 

This is a predefined constant; the value is always 2 
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Table A-2. Predefined Names (cont) 


Name 


Assignment Command and Description 






BIN10 


(You 
This 


cannot assign value.) 

is a predefined constant; the value is always 4. 






BINHLF 


(You 
This 


cannot assign value.) 

is a predefined constant; the value is always 5. 






BIN521 


(You 
This 


cannot assign value.) 

is a predefined constant; the value is always 6. 






BO 


(You 
This 


cannot assign value.) 

is a predefined constant; the value is always 2. 






CURRENT 












(You cannot assign value directly.) 

This name points to the current edit block. You set it using the 
EDIT command, and use it when block expressions specify no 
explicit enclosing block. You can use CURRENT to refer to the 
entire edit block for movement, data selection, etc. (See Section 
5, Block Expressions in 6Edit.) 6Edit accepts the "CURR" 
abbreviation. 


DONT_PROTECT 










(You 
This 


cannot assign value.) 

is a predefined constant; the value is always 2. 
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Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



EO 

(You cannot assign value.) 

This is a predefined constant; the value is always 3. 



FORWARD 

(You cannot assign value.) 

This is a predefined constant; the value is always 1. 



HERE 

(You cannot assign value directly.) 

HERE points to the current location of 6Edit's file pointer. 
6Edit updates the value of HERE automatically after performing 
each editing command. 



NEW 

(You cannot assign value.) 

This is a predefined constant; the value is always 1. 



OFF 

(You cannot assign value.) 

This is a predefined constant; the value is always 0. 



OLD 

(You cannot assign value.) 

This is a predefined constant; the value is always 2. 
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Table A-2. Predefined Names (cont) 



Name Assignment Command and Description 



ON 

(You cannot assign value.) 

This is a predefined constant; the value is always 1. 



PROTECT 

(You cannot assign value.) 

This is a predefined constant; the value is always 1. 



STRING 

(You cannot assign value.) 

This is a predefined constant; the value is always 7. 



THAT 

(You cannot assign value directly.) 

This name points to the current selected block, the block operated 
on by the last editing command. 6Edit updates the value of this 
name automatically after each editing command. If the last 
editing command deleted its operand, THAT points to the empty 
block where the deleted operand resided. This empty block can 
then be used as the destination of a new insertion replacing the 
deleted operand. 
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Appendix B 

Predefined String Functions 



This appendix Lists the string functions supported by 6Edit and their 
descriptions. (See Section 4, String Expressions, for more information on 
string expressions.) 



Table B-1. String Functions 



Name Description 



$ABS(expression) 

Returns the absolute value of the expression. The expression must 

be numeric. 



$ACCT 

Returns the account portion of the current logon. 



$CMDVAR( command_var iable_name) 

Returns the value of a command variable defined in IBEX with !LET, 
which is compatible with the variables defined in 6Edit with 
EQUALS. $CMDVAR( command_var iable___name) allows access to the 
values of variables defined in IBEX just as %command__var iable_name 
is used in IBEX. 



$CNTL(expression) 

Returns the expression string as though the control key had been 
depressed. For example, $CNTL(*[W') is equivalent to 
<ESC>I l<CNTL-W>. 



CE70-02 



Predefined String Functions 



B-1 



Table B-1. String Functions (cont) 



Name Description 



$DATE 

Returns the date in the form YYMMDD. An optional parameter 
TYPE='type' may be supplied. The 'type' expression may be EXT, 
ANS, or LOCAL. For example: 

lOUTPUT $DATE (TYPE='ANS') 
841203 

iOUTPUT $DATE (TYPE='EXT') 
DEC 03 '84 

•OUTPUT SDATE (TYPE= ' LOCAL ' ) 
12/03/84 



$DAY 



Returns SUN, nON, TUE, WED, THU, FRI, or SAT. 



SDIR 



Returns the current directory account. 



$EOF 



Returns 1 if an end-of-file has been encountered on M$UC. Returns 
0 otherwise. 



$F1D_ASN( express ion) 

Expression is evaluated to a string that is treated as a file 
name. $FID_ASN performs a call to MSFID, but does not try to OPEN 
the FID. If the M$FID call was successful, the assignment type 
(ASN) is returned. Examples are FILE, DEVICE, and COMGROUP. If 
the file does not exist or cannot be accessed, then an error 
message is displayed, and the command is aborted. 
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Table B-1. String Functions (cont) 



Name Description 



$F I D_EXIST( express ion) 

Expression is evaluated as a string that is treated as a file 
name. If an attempt by IBEX to open the file yields any result 
other than "file does not exist", then $FID_EXIST returns a 1. 
This is no guarantee that the user may access the file. Returns a 
0 otherwise. If the file does not exist or cannot be accessed, 
then an error message is displayed, and the command is aborted. 



$F I D_6RANS( express ion) 

Expression is evaluated as a string that is treated as a file 

name. $FID_GRANS specifies the size of the file in total number 

of granules. If the file does not exist or cannot be accessed, 

then an error message is displayed, and the command is aborted. 



$F I D_N6AVAL( express ion) 

Expression is evaluated as a string that is treated as a file 
name. $FID_NGAVAL specifies the size of the file in number of 
unused granules in the file. If the file does not exist or cannot 
be accessed, then an error message is displayed, and the command 
is aborted. 



$F I D_0R6( express ion) 

Expression is evaluated as a string that is treated as a file 
name. CONSEC, KEYED, RANDOM, INDEXED, RELATIVE, IDS, etc. If the 
file does not exist or cannot be accessed, then an error message 
is displayed, and the command is aborted. 



$F I D_RECS( express ion) 

Expression is evaluated as a string that is treated as a file 
name. $FID_RECS specifies the size of the file in number of 
records. If the file does not exist or cannot be accessed, then 
an error message is displayed, and the command is aborted. 
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Table B-1. String Functions (cont) 



Name Description 



$F I D_TYPE( express ion) 

$FID_TYPE returns the two-character file type of the file. If the 
file does not exist or cannot be accessed, then an error message 
is displayed, and the command is aborted. 



$F I D_UGRANS( express ion) 

Expression is evaluated as a string that is treated as a file 
name. $FID_UGRANS specifies the size of the file in number of 
Ugranules. If the file does not exist or cannot be accessed, then 
an error message is displayed, and the command is aborted. 



$FLA6( f name) 

SFLAG returns YES if a particular IBEX flag is set; otherwise it 
returns NO. The fname may be any of the following: 

PROTECT DRIBBLE AC/CEPT BRO/ADCAST 

LIST ECHO AC/CEPT SEND 

COMMENT NOTIFY AC/CEPT AN/NOUNCE 



$HSET 



Returns the home packset name. 



SINDEXCexpression 1, expression 2[, expression 3[, expression 4]]) 

Expressions 1 and 2 are evaluated to strings of characters; 
expressions 3 and 4, if given, must be numeric. SINDEX returns 
the index into expression 1 where expression 2 was found. If 
expression 2 is not found, the Length of expression 1 is returned. 
If both 3 and 4 are omitted, then all of expression 1 is searched 
for expression 2. If expression 3 is included, then it specifies 
the beginning position for the search within expression 1. If 
expression 4 is included, then it specifies the ending position 
for the search within expression 1. The first character in the 
string is position 0. 
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Table B-1. String Functions (cont) 



Name Descr ipt ion 



$INPUT(expression) 

Prompts through the command window (M$ME) with expression. 
Returns a reply from the user. If the user's reply includes 
leading or trailing blanks, these are stripped from the input. 
When the user desires the blanks not be stripped, the input string 
must be enclosed in quotes (which will be stripped). Doubled 
quotes within a quote string are translated to a single quote in 
the resultant string. 



$KEY( keyname) 

Specifies the keyin name ( str ing_express ion_1 ) in a KEYIN command; 
can be used in an EQUALS command to define a KEYIN introducer. 
$KEY can also be used anywhere else with a standard ASCII control 
character mnemonic or a hex value as the keyname parameter, and is 
simply an alternate way to express the indicated character. 

See the KEYIN command in Section 3 for more information. 



$KEYIN( express ion) 

Sends expression to the system consoles. $KEYIN suspends 
execution until it receives a reply from the system console. 
SKEYIN then takes on the value of the reply. If the user's reply 
includes leading or trailing blanks, these are stripped from the 
input. When the user desires the blanks not be stripped, the 
input string must be enclosed in quotes (which will be stripped). 
Doubled quotes within a quote string are translated to a single 
quote in the resultant string. 



SLASTBATCH 

Returns the sysid of the last job issued via the BATCH command. 
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Table B-1. String Functions (cont) 



Name Descr ipt ion 



$LEN6TH( express ion) 

Returns the number of characters in expression. The Length of a 
string expression is one greater than the Last character used in 
that expression. 



$LOC(express ion) 

Returns the string expression converted to Lower case. 



$MAX(exp1,exp2, expn) 



Returns the value of the Largest expression. All expressions must 
be numeric. 



$MIN(exp1,exp2,. . .expn) 



Returns the value of the smallest expression. All expressions 
must be numeric. 



$M0D(exp1, exp2) 



Returns the arithmetic modulus of expl and exp2. Both exp1 and 
exp2 must be numeric. 



SMODE 



Returns ONLINE, BATCH, GHOST, or TP, whatever mode in which the 
user currently operates. 



$NAME 

Returns the name portion of the logon. 
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Table B-1. String Functions (cont) 



Name Description 



$PRIV_ACTIVE(pname) 

Returns YES if a particular IBEX PRIV bit is turned on. The pname 
may be FMSEC, etc. 



$PRIV_AUTH( pname) 

Returns YES if a particular IBEX PRIV bit is authorized. The 
pname may be FMSEC, etc. 



$REM(exp1, exp2) 

Returns the remainder of expl and exp2. Both exp1 and exp2 must 
be numeric; exp2 may not be 0. 



SRERUN 

Returns 1 if this job is being rerun automatically by the system. 
Otherwise, it returns 0. 



$SEARCH{expression 1, expression 2[, express ion 3[, express ion 4]]) 

Expressions 1 and 2 are evaluated to strings of characters; 
expressions 3 and 4, if given, must be numeric. SSEARCH checks 
each character in expression 1 for membership in expression 2. 
The index of the first match is returned; if not found the length 
of expression 1 is returned. If expression 3 is included, then it 
specifies the beginning position for the search within expression 
1. If expression 4 is included, then it specifies the ending 
position for the search within expression 1. The first character 
in the string is position 0. 
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Table B-1. String Functions (cont) 



Name Description 



$SITE 

Returns the textual site identification. 



$SUBSTR(expression 1[, expression 2[, expression 3]]) 

Expression 1 is evaluated to a string of characters; expressions 2 
and 3, if given, must be numeric. A character string is extracted 
from expression 1 beginning at the nth position as specified by 
expression 2 with a length specified by expression 3. If 
expression 2 is not specified then the first character is assumed. 
If expression 3 is not specified then the Length of expression 1 
minus expression 2 is assumed. The first character in the string 
is position 0. 



$SWITCH( express ion) 

Returns the value 0 or 1 of the specified SWITCH. The expression 
must evaluate to a numeric value between 0 and 35. Switches are 
set by the IBEX SWITCH command. 



SSYSID 

Returns the user's sysid. 



$TERM__FEP 

Returns node of the user's PEP. 



$TERM_LINE 

Returns the channel to which the user is connected. 
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Table B-1. String Functions (cont) 



Name Descr ipt ion 



$TERM_PROFILE 

Current terminal profile. 



$TERM_SPEED 

Returns communication speed in bits per second, e.g. 300, 1200, 
etc. 

Note: The TERM functions will return an error message if mode is 
not ONLINE. 



STIME 

Returns the current time in the form HHMM. An optional parameter 
TYPE=*type' may be supplied. The 'type' expression may be EXT, 
ANS, or LOCAL. For example: 

lOUTPUT STIME (TYPE='ANS') 
1224 

! OUTPUT STIME (TYPE='EXT') 
12:24 

lOUTPUT STIME (TYPE='L0CAL' ) 
12:24 



$UPC(express ion) 

Returns the string expression converted to upper case. 



SVERIFYCexpression 1, expression 2[, expression 3[, expression 4]]) 

Expressions 1 and 2 are evaluated to strings of characters; 
expressions 3 and 4, if given, must be numeric. Each character of 
expression 1 is checked for membership in expression 2. SVERIFY 
returns the first non-match; if not found, it returns the length 
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Table B-1. String Functions (cont) 


Name 


Descr ipt ion 




of the expression. If expression 3 is included, then it specifies 
the beginning position for the search within expression 1. If 
expression 4 is included, then it specifies the ending position 
for the search within expression 1. The first character in the 




string is position 0. 


SVERSION 




Returns the current version of the CP-6 system. 


$woo 


Returns the current workstation of origin. 
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Appendix C 

Context Files in 6Edit 



This appendix illustrates several context files for 6Edit. The function 
descriptions in Table C-2 remain constant regardless of the context file in 
use. Their key strokes, however, vary with each context file. 

The files described here set up the 6Edit editor for their various terminal 
environments. 

A context file defines: 

0 The keys and key sequences used on your terminal to invoke 6Edit's special 
input editing functions (such as "move cursor to command window"), as well 
as many common commands. 

o Names for the ASCII control characters used to invoke 6Edit's special 

input editing functions. These are helpful when you use the KEYIN command 
interactively to define keys on your terminal. 

o Synonyms for several commonly-used phrases in the 6Edit command language. 

Table C-1 describes the standard names and their values. These names apply to 
all context files. 



Table C-1. Standard Names in a Context File 



Command Description 



CMD EQ '%V(3)' ... 

A series of commands similar to this one defines the activation 
characters which invoke 6Edit's special input editing functions. 
This allows you to use the name "CMD" in string expressions; 
6Edit uses the correct binary value. 

In addition, the value of the ASCII Escape and carriage return 
control characters is given a name, so that it can be used more 
easily in 6Edit expressions. 
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Table C-1. Standard Names in a Context File (cont) 



Command Description 



These names are most useful in KEYIN commands, which redefine 
the keys of your terminal keyboard. For example, to tell 6Edit 
that the sequence of keys "Escape Z" should cause the cursor to 
move to the end of the next record, use the following KEYIN 
command: 

KEYIN ESCII'Z' IS ESC I I 'B' I I ESC I I 'N' 



SYNONYM REKEY COPY BLOCK OVER BLOCK 

REKEY can be used to rekey (renumber) a file. It can only be 
used when you are currently editing the entire file to be 
rekeyed. By default, REKEY uses 10 as the key increment. To 
rekey the file by a specific key increment, append the BY option 
to the REKEY synonym; for example: 

REKEY BY 1 

or 

REKEY BY 2.5 



SYNONYM SHL DELETE THAT EACH BO RECORD THRU POSITION 

SHL can be used to shift a block of records left some number of 
positions. Before using SHL, you must select a block of text. 
(See Section 1, Overview of 6Edit.) Note that the block you 
select must begin and end at the beginning of records; that is, 
the beginning of the block must be at the beginning of the first 
record to be shifted, and the end of the block must be at the 
beginning of the record following the last record to be shifted. 

Once you have selected the block, go to the command window, and 
type: 

SHL 4 

This shifts the block of records left 4 positions. To shift a 
different number of positions, specify that number after the SHL 
synonym. 
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Table C-1. Standard Names in a Context File (cont) 


uommanu 


uescr ipx i un 


SYNONYM 


EACH REPEAT SELECT RECORD SELECT 




EACH can be used in a command to cause an editing operation to 




be repeated on each record in a block. For example, to insert a 




string at the beginning of each record in the selected block. 




type: 




COPY ST 'xxx' AFTER THAT EACH BO RECORD 




Or, to delete positions 10 through 13 from each record in the 




selected block, type: 




DELETE THAT EACH PO 10 THRU PO 13 
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Figure C-1 illustrates the standard context file for 6Edit. The standard 
context file can be used with any terminal. The name of this file is: 



:6EDIT CONTEXT.: LIBRARY 



" Standard synonyms and values 

SYNONYM REKEY IS COPY CURRENT OVER CURRENT 
SYNONYM EACH IS REPEAT SELECT RECORD SELECT 
SYNONYM SHL IS DELETE REPEAT SELECT RECORD SELECT 
ESC EQ '%V(27)'; CR EQ '%V(13)' 

" Special input activation characters for 6Edit 

CMD EQ '%V(3)' 

" Cursor movement keyins 



BO RECORD THRU POSITION 



KEYIN 


'%V(21)' 


IS 


ESCI 1 'A' 




"BACKWARD 1 <CNTL-U> 


KEYIN 


•%V(22)' 


IS 


ESC 1 1 'B' 




"FORWARD 1 <CNTL-V> 


KEYIN 


ESCI 1 'W 


IS 


CMD 1 1 'BACKWARD SKIP 8 BO 


RECORDS' 1 ICR 












"BACKWARD 8 <ESC> <W> 


KEYIN 


ESCI 1 'E' 


IS 


CMDI 1 'SKIP 8 BO RECORDS' 1 


ICR 


"FORWARD 8 <ESC> <E> 


KEYIN 


ESCI 1 'A' 


IS 


CMD 1 1 'BACKWARD SKIP 20 BO 


RECORDS' 1 ICR 












"BACKWARD 20 <ESC> <A> 


KEYIN 


ESCI 1 'L' 


IS 


CMDI 1 'SKIP 20 BO RECORDS' 


1 ICR 


"FORWARD 20 <ESC> <L> 


KEYIN 


ESC 1 1 'P' 


IS 


CMDI 1 'BACKWARD SKIP 1 ' " 


'%V(8)%V(27)>' 












'BACKWARD PATTERN <ESC> <P> 


KEYIN 


'%V(16)' 


IS 


CMDI 1 'SKIP 1 " "%V(8)%V(27)> 


' "FORWARD PATTERN <CNTL-P> 


KEYIN 


ESCI 1 'B' 


IS 


CMDI 1 'BO CURRENT' 1 ICR 




"<ESC> <B> 


KEYIN 


ESC 1 1 'F' 


IS 


CMDI 1 'EO CURRENT' 1 ICR 




"<ESC> <F> 


KEYIN 


ESCI 1 ' . • 


IS 


CMDI 1 'L' 1 ICR 




"<ESC> <.> 




- Block edit 


ing keyins 






KEYIN 


'%V(7)' 


IS 


CMD 




"<CNTL-G> 


KEYIN 


'%V(20)' 


IS 


CMDI 1 'THRU' 1 ICR 




"<CNTL-T> 


KEYIN 


'%V(1)' 


IS 


CMDI 1 'ADJUST' 1 ICR 




"<CNTL-A> 


KEYIN 


ESCI 1 'V 


IS 


CMDI 1 'COPY THAT' 1 ICR 




"<ESC> <1> 


KEYIN 


ESCI 1 • ! ' 


IS 


CMDI 1 'MOVE THAT' 1 ICR 




"<ESC> <!> 


KEYIN 


ESC 1 1 '3' 


IS 


CMDI 1 'COPY RECORD' 1 ICR 




"<ESC> <3> 


KEYIN 


ESCI 1 


IS 


CMDI 1 'MOVE RECORD' 1 ICR 




"<ESC> <ft> 


KEYIN 


ESCI 1 'A' 


IS 


CMDI 1 'COPY L AFTER HERE' 1 


ICR 


"<ESC> <A> 


KEYIN 


ESCI 1 


IS 


CMDI 1 'MOVE L AFTER HERE' 1 


ICR 


"<ESC> <$> 


KEYIN 


ESCI 1 •/' 


IS 


CMDI 1 'AFTER HERE' 1 ICR 




"<ESC> </> 


KEYIN 


ESCI 1 'a* 


IS 


CMDI 1 'OVER THAT' 1 ICR 




"<ESC> <S)> 


KEYIN 


ESCI 1 


IS 


CMDI 1 'DELETE THAT' 1 ICR 




"<ESC> <*> 


KEYIN 


ESC II' ' 


IS 


CMDI 1 'EDIT THAT' 1 ICR 




"<ESC> < > 



C-A 



Figure C-1. Standard Context File (cont. next page) 
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KEYIN ESCII'E' IS CMDII'EDIT PREVIOUS ' I I CR "<ESC> <[> 

KEYIN ESCI I ']' IS CMDI I 'EDIT NEXT* I ICR "<ESC> <]> 

KEYIN ESCII':' IS CMD I I 'LOCATION L IS THAT' I ICR "<ESC><:> 
KEYIN ESCII • = ' IS CMDII'COPY STRING "" OVER REPEAT SELECT ""'11; 
'%V(27)%V(13)%V(27)V"%V(18)%V(27)>' "SUBSTITUTE <ESC> < = > 



Figure C-1. Standard Context File 
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Figure C-2 illustrates the context file for the DEC VT 100 terminal. The name 
of this file is: 



:6EDIT CONTEXT DECVT 100. : LIBRARY 



II 


Standard synonyms and values 




SYNONYM REKEY IS COPY CURRENT OVER CURRENT 




SYNONYM EACH IS REPEAT SELECT RECORD SELECT 




SYNONYM SHL IS DELETE REPEAT SELECT RECORD SELECT 


BO RECORD THRU POSITION 


ESC EG 


I <ESC>; CR EQ <CR> 




$END_MARK EQ ' —end—' 




II 


- Parameters 




$INTR0_1 EQ ESC 




1 1 


- Special input activation characters for 6Edit 


CMD EQ '%V(3)' 






- Cursor movement keyins 




KEYIN 


<UPARROW> IS ESC 1 1 'A' 


"BACKWARD 1 <Up Arrow> 


KEYIN 


<DNARROW> IS ESC 1 1 'B' 


"FORWARD 1 <Down Arrow> 


KEYIN 


<RTARROW> IS ESC 1 1 'C 


"RIGHT 1 <Right Arrow> 


KEYIN 


<LTARROW> IS ESC 1 1 'D' 


"LEFT 1 <Left Arrow> 


KEYIN 


<PF3> IS <ESC>I 1 '8A' 


"BACKWARD 8 <PF3> 


KEYIN 


<PF4> IS <ESC>I 1 '8B' 


"FORWARD 8 <PF4> 


KEYIN 


<PF1> IS <ESC>i i '20A' 


"BACKWARD 20 <PF1> 


KEYIN 


<PF2> IS <ESC>i 1 '20B' 


"FORWARD 20 <PF2> 


KEYIN 


<UF10> IS CMDII'BA SK 1 PA $INPUT( ' ' Sear ch 


Pattern: " ) ' 1 ICR 






"BACKWARD PATTERN <Pad ,> 


KEYIN 


<ENTER> IS CMDII'SKIP 1 PA $INPUT( " Sear ch 


Pattern: ")' 1 ICR 




"FORWARD PATTERN <Pad Enter> 


KEYIN 


<UF5> IS CMDII'BO CURRENT' NCR 


"<Pad 5> 


KEYIN 


<UF6> IS CMDII'EO CURRENT' NCR 


"<Pad 6> 


KEYIN 


<CNTL-L> IS CMDI 1 'L' I ICR 


"<CNTL-L> 


11 


- Block editing keyins 




KEYIN 


<CNTL-A> IS CMD 


"<CNTL-A> 


KEYIN 


<UFO> IS CMDI 1 'THRU' 1 ICR 


"<Pad 0> 


KEYIN 


<UF11> IS CMDII 'ADJUST' NCR 


"<Pad -> 


KEYIN 


<UF7> IS CMDII 'COPY THAT' NCR 


"<Pad 7> 


KEYIN 


ESC!!'!' IS CMDII 'MOVE THAT' NCR 


"<ESC> <!> 


KEYIN 


<UF4> IS CMDII 'COPY RECORD' NCR 


"<Pad 4> 


KEYIN 


ESCII'#' IS CMDII 'MOVE RECORD' NCR 


"<ESC> <#> 


KEYIN 


<UF9> IS CMDII 'COPY L AFTER HERE' NCR 


"<Pad 9> 


KEYIN 


<ESC>II<5)> IS CMDII 'MOVE L AFTER HERE' NCR 


"<ESCxa> 


KEYIN 


<UF8> IS CMDII 'AFTER HERE' NCR 


"<Pad 8> 


KEYIN 


<ESC>II<$> IS CMDII 'OVER THAT' NCR 


"<ESCx$> 


KEYIN 


<ESC>II<%> IS CMDII 'DELETE THAT' NCR 


"<ESCx%> 


KEYIN 


<UF2> IS CMDII 'EDIT THAT' NCR 


"<Pad 2> 



Figure C-2. DECVT100 Context File (cont. next page) 
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KEYIN <UF1> IS CMDII'EDIT PREVIOUS ' I I CR "<Pad 1> 

KEYIN <UF3> IS CMDII'EDIT NEXT' I ICR "<Pacl 3> 

KEYIN <UF12> IS CMD I I ' LOCATION L IS THAT' I ICR "<Pad .> 
KEYIN <CNTL-T> IS CMD I I; 

'CO ST SINPUTC'New string:") OVER REPE SE PA $INPUT("OLd string:")'ll; 

CR "SUBSTITUTE <CNTL-T> 

KEYIN <LF> IS ESCII<LF> "SPLIT <LF> 



Figure C-2. DECVT100 Context File 
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Figure C-3 illustrates an example context file for an IBM PC-compatible 
personal computer using the PC Terminal Facility (PCT) with the PCTX364 
profile. The name of this file is: 

:6EDIT CONTEXT PCTX364. : LIBRARY 



!SET M$LL UC,ORG=T "Allows RESTORE command to work 

Replace TOGKEYPAD with KEYPADON if on new release of PCT 
SINITIALIZE EQ 'SHOW STRING ' •%V(27)_T0GKEYPAD%V(27)\ "%R' I I "Keypad mode"; 

'!SET M$LL UC,0RG=T%R' I I "Make SRESTORE work properly"; 

'lEJECT UC01%R'II "Blank screen at 1st entry to 6Edit"; 

'!EJECT%R' "Reposition cursor to bottom 

$MIN_COMMAND EQ 2 

Replace TOGKEYPAD with KEYPADOFF if on new release of PCT ***** 
SRESTORE EQ 'OUTPUT " ' I KESO I I '_TOGKEYPAD ' I KESOl I ' \ ' " 
"***** 

$VSCROLL_MARGIN EQ 0 
SVSCROLL EQ 1 

"***** Replace TOGKEYPAD with KEYPADON if on new release of PCT ***** 

SHOW STRING <ESC> I I '_TOGKEYPAD ' I KESO I I ' \ ' 

"***** 

" Standard synonyms and values 

SYNONYM EACH IS REPEAT SELECT RECORD SELECT 
SYNONYM REKEY IS COPY CURRENT OVER CURRENT 

SYNONYM SHL IS DELETE REPEAT SELECT RECORD SELECT BO RECORD THRU POSITION 
ESC EQ <ESC>; CR EQ <CR> 

" Custom synonyms and values 

$END_MARK EQ ' end ' 

Special input activation characters for 6Edit 

CMD EQ '%V(3)' 

" Cursor movement key ins 

KEYIN <CNTL-G> IS CMD "COMMAND <CNTL-G> 

KEYIN <UPARROW> IS ESCII'A' "BACKWARD 1 <Up Arrow> 

KEYIN <DNARROW> IS ESC I I 'B' "FORWARD 1 <Down Arrow> 

KEYIN <RTARROW> IS <DC2> "RIGHT 1 <Right Arrow> 

KEYIN <LTARROW> IS <BS> "LEFT 1 <Left Arrow> 

KEYIN <SCROLL_SEG_UP> IS <ESC>I I •20A' "BACKWARD 20 <Page Up> 

KEYIN <SCROLL_SEG_DOWN> IS <ESC>II'20B' "FORWARD 20 <Page Down> 

KEYIN <SU15> IS <ESC>II'8A' "BACKWARD 8 <CNTL-Page Up> 

KEYIN <SU1A> IS <ESC>II'8B' "FORWARD 8 <CNTL-Page Down> 

KEYIN <HOME> IS CMDII'BO CURRENT' I ICR "<Home> 
KEYIN <SU16> IS CMDII'BO THAT' I ICR "<CNTL-Home> 
KEYIN <UF11> IS CMDII'EO CURRENT' I ICR "<End> 
KEYIN <SU11> IS CMDII'EO THAT' NCR "<CNTL-End> 
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Figure C-3. PCTX364 Context File (cont. next page) 
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KEYIN 


<FF> 


IS 


CMDI 


'L' 1 ICR 


"<CNTL-L> 




- File 


positioning 




KEYIN 


<DLE> 


IS 


CMDI 


'EDIT PREVIOUS' 1 ICR 


••<CNTL-P> 


KEYIN 


<S0> 


IS 


CMDI 


'EDIT NEXT' 1 ICR 


"<CNTL-N> 




- Pattern defin 


ition and searching 




KEYIN 


<UF1> 


IS 


CMDI 


'BA SK 1 PA $1NPUT( "Search Pattern: ")' 1 1 CR 












"BACKWARD PATTERN <CNTL-F1> 


KEYIN 


<UF2> 


IS 


CMDI 


'SKIP 1 PA $INPUT( "Search 


Pattern: " ) ' 1 ICR 












"FORWARD PATTERN <CNTL-F2> 


KEYIN 


<F11> 


IS 


CMDI 


•BA SK 1 PA " " ' 1 ICR 


"BACKWARD PATTERN <ALT-F1> 


KEYIN 


<F12> 


IS 


CMDI 


'SKIP 1 PA " " ' NCR 


"FORWARD PATTERN <ALT-F2> 




- Block 


edi t ing 


key ins 




KEYIN 


<LF> 


IS 


ESC 1 


<LF> IN EDITING WINDOW 


"SPLIT <LF> 


KEYIN 


<F9> 


IS 


ESC 1 


<FF> IN EDITING WINDOW 


"DELETE RECORD <F9> 


KEYIN 


<F1> 


IS 


CMDI 


•COPY RECORD' 1 ICR 


"<F1> 


KEYIN 


<F2> 


IS 


CMDI 


'MOVE RECORD' 1 ICR 


"<F2> 


KEYIN 


<F3> 


IS 


CMDI 


'LOCATION L IS THAT' 1 ICR 


"<F3> 


KEYIN 


<FA> 


IS 


CMDI 


•COPY L AFTER HERE' 1 ICR 


"<FA> 


KEYIN 


<F5> 


IS 


CMDI 


'MOVE L AFTER HERE' 1 ICR 


"<F5> 


KEYIN 


<SOH> 


IS 


CMDI 


'AFTER HERE' 1 ICR 


"<CNTL-A> 


KEYIN 


<STX> 


IS 


CMDI 


•THRU' 1 ICR 


"<CNTL-B> 


KEYIN 


<ETX> 


IS 


CMDI 


•COPY THAT' 1 ICR 


"<CNTL-C> 


KEYIN 


<EOT> 


IS 


CMDI 


'DELETE THAT' 1 ICR 


"<CNTL-D> 


KEYIN 


<ENQ> 


IS 


CMDI 


'EDIT THAT' 1 ICR 


"<CNTL-E> 


KEYIN 


<VT> 


IS 


CMDI 


'ADJUST' 1 ICR 


"<CNTL-K> 


KEYIN 


<SI> 


IS 


CMDI 


'OVER HERE' 1 ICR 


"<CNTL-0> 


KEYIN 


<CNTL- 


T> IS CMDI 1; 




'CO ST SINPUTC 


'New 


String: ") OVER REPE SE PA 


$INPUT("0ld string: ")' 1 1; 


CR 










"SUBSTITUTE <CNTL-T> 


KEYIN 


<SYN> 


IS 


CMDI 


'MOVE THAT' 1 ICR 


"<CNTL-V> 



Figure C-3. PCTX364 Context File 



CE70-02 



Context Files in 6Edit 



C-9 



Figure C-4 illustrates the context file for the Honeywell VIP7205 terminal. 
The name of this file is: 



:6EDIT CONTEXT VIP7Z05 .: LIBRARY 



" Standard synonyms and values 

SYNONYM REKEY IS COPY CURRENT OVER CURRENT 
SYNONYM EACH IS REPEAT SELECT RECORDS SELECT 

SYNONYM SHL IS DELETE REPEAT SELECT RECORD SELECT BO RECORD THRU POSITION 
ESC EQ '%V(27)'; CR EQ '%V(13)' 

" Special input activation characters for 6Edit 

CMD EQ '%V(3)' 

" Cursor movement keyins 

KEYIN ESCII'A' IS ESCII'A' "BACKWARD 1 <Up Arrow> 

KEYIN ESC I I 'B' IS ESC I I 'B' "FORWARD 1 <Down Arrow> 

KEYIN ESCirS' IS CMD I I 'BACKWARD SKIP 8 BO RECORDS' I ICR 

"BACKWARD 8 <SHIFT-F2> 
KEYIN ESCII'2' IS CMDII'SKIP 8 BO RECORDS' I ICR "FORWARD 8 <F2> 
KEYIN ESCII'7' IS CMD I I 'BACKWARD SKIP 20 BO RECORDS' I ICR 

"BACKWARD 20 <SHIFT-F3> 
KEYIN ESC I I '6' IS CMDII'SKIP 20 BO RECORDS' NCR "FORWARD 20 <F3> 
KEYIN ESCirr IS CMD I I 'BACKWARD SKIP 1 " "%V(8)%V(27)>' 

"BACKWARD PATTERN <SHIFT=F1> 
KEYIN ESCII'O' IS CMDII'SKIP 1 " "%v(8)%V(27)>' "FORWARD PATTERN <F1> 
KEYIN ESC I I 'T' I S CMD I I ' BO CURRENT ' I I CR "<ESC> <T> 

KEYIN ESC I I 'F' IS CMD I I ' EO CURRENT ' I I CR "<ESC> <F> 

KEYIN ESCI I 'L' IS CMD I I ' L' I I CR "<ESC> <L> 

" Block editing keyins 

KEYIN ESC I I • " IS CMD "<CLR> 

KEYIN ESCI I 'i' IS CMD I I ' THRU ' I I CR "<XMIT> 

KEYIN '%V(1)' IS CMDI I 'ADJUST' I ICR "<CTRL-A> 

KEYIN ESCI I':' IS CMDI I 'COPY THAT' NCR "<F5> 

KEYIN ESCI I';' IS CMDI I 'MOVE THAT' NCR "<SHIFT-F5> 

"KEYIN IS CMDI I 'COPY RECORD' I ICR" "<CLR> CO RE <RETURN> 

"KEYIN IS CMDI I 'MOVE RECORD' I ICR" "<CLR> MO RE <RETURN> 

"KEYIN IS CMDII'COPY L AFTER HERE' I ICR" "<CLR> CO L AF HERE <RETURN> 

"KEYIN IS CMDI I 'MOVE L AFTER HERE' I ICR" "<CLR> MO L AF HERE <RETURN> 

KEYIN ESCII'<' IS CMDI I 'AFTER HERE' I ICR "<F6> 

"KEYIN IS CMDirOVER THAT' I ICR" "<CLR> OV THAT <RETURN> 

KEYIN ESCII'=' IS CMDI I 'DELETE THAT' NCR "<SHIFT-F6> 

"KEYIN IS CMDII'EDIT THAT' NCR" "<CLR> ED THAT <RETURN> 
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"KEYIN IS CMDII'EDIT PREVIOUS * I I CR" ••<CLR> ED PREV <RETURN> 

"KEYIN IS CMDII'EDIT NEXT' I ICR" "<CLR> ED NEXT <RETURN> 

KEYIN ESCII'9' IS CMD II 'LOCATION L IS THAT* I ICR "<SHIFT-F4> 
KEYIN ESCII'8' IS CMDII'COPY STRING "" OVER REPEAT SELECT '""II; 
'%V(27)%V(13)%V(27)V"%V(18)%V(27)>' "SUBSTITUTE <FA> 



Figure C-4. VIP7205 Context File 
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Figure C-5 illustrates the context file for Honeywell VIP7801 or VIP7802 
terminals. The name of this file is: 



:6EDIT CONTEXT VIP7801 .: LIBRARY 



" Standard synonyms and values 

SYNONYM REKEY IS COPY CURRENT OVER CURRENT 
SYNONYM EACH IS REPEAT SELECT RECORD SELECT 

SYNONYM SHL IS DELETE REPEAT SELECT RECORD SELECT BO RECORD THRU POSITION 
ESC EQ '%V(27)'; CR EQ '7oV(13)'; $INTR0_2 EQ '%V(27)[' "VIP78xx's only 

" Special input activation characters for 6Edit 

CMD EQ 'XVCS)' 

" Cursor movement keyins 

KEYIN ESCII'A' IS ESCII'A' "BACKWARD 1 <Up Arrow> 

KEYIN ESCII'B' IS ESCll'B* "FORWARD 1 <Down Arrow> 

KEYIN ESCII'Cr IS CMD I I 'BACKWARD SKIP 8 BO RECORDS' I ICR 

"BACKWARD 8 <DEL/CHAR/INS> 
KEYIN ESCI1'[L' IS CMDIl'SKIP 8 BO RECORDS' I ICR "FORWARD 8 <DEL/LINE/INS> 
KEYIN ESCII'[P' IS CMDII 'BACKWARD SKIP 20 BO RECORDS' I ICR 

"BACKWARD 20 <SHIFT-DEL/CHAR/INS> 
KEYIN ESCII'[M' IS CMDIl'SKIP 20 BO RECORDS' I ICR 

"FORWARD 20 <SHI FT-DEL/LINE/INS> 
KEYIN ESCII'V IS CMD II 'BACKWARD SKIP 1 " "%V(8)%v(27)>' 

"BACKWARD PATTERN <SHIFT-F1> 
KEYIN ESCII'O' IS CMDIl'SKIP 1 " " 7oV( 8)%V( 27) >' "FORWARD PATTERN <F1> 
KEYIN ESCII'5' IS CMDII 'BO CURRENT' NCR "<SHIFT-F2> 
KEYIN ESCll'2' IS CMDII'EO CURRENT' NCR "<F2> 
KEYIN ESC I I 'L' IS CMD I I ' L ' II CR "<ESC> <L> 

" Block editing keyins 

KEYIN ESCII'e' IS CMD "<CLEAR/RESET> 

KEYIN ESCII'i' IS CMD II ' THRU ' I I CR "<TRANSMIT> 

KEYIN ESCII'" IS CMDI I 'ADJUST' I ICR "<SHI FT-CLEAR/RESET> 

KEYIN ESCII':' IS CMDI I 'COPY THAT' I ICR "<F5> 

KEYIN ESCII';' IS CMDII 'MOVE THAT' I ICR "<SHIFT-F5> 

"KEYIN IS CMDII 'COPY RECORD' I ICR" "<CLEAR/RESET> CO RE <RETURN> 

"KEYIN IS CMDII 'MOVE RECORD' I ICR" "<CLEAR/RESET> MO RE <RETURN> 

"KEYIN IS CMDI I 'COPY L AFTER HERE' I ICR" 

"<CLEAR/RESET> CO L AF HERE <RETURN> 

"KEYIN IS CMDII 'MOVE L AFTER HERE' I ICR" 

"<CLEAR/RESET> MO L AF HERE <RETURN> 
KEYIN ESCII'<' IS CMDM'AFTER HERE' I ICR "<F6> 

"KEYIN IS CMDI I 'OVER THAT' I ICR" "<CLEAR/RESET> OV THAT <RETURN> 

KEYIN ESC 11' = ' IS CMDI I 'DELETE THAT' I ICR "<SHIFT-F6> 

"KEYIN IS CMDI I 'EDIT THAT' I ICR" "<CLEAR/RESET> ED THAT <RETURN> 



Figure C-5. VIP7801/VIP7802 Context File (cont. next page) 
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"KEYIN IS CMDII'EDIT PREVIOUS ' 1 1 CR" 


"<CLEAR/RESET> ED PREV 


<RETURN> 


"KEYIN IS CMDII'EDIT NEXT' NCR" 


"<CLEAR/RESET> ED NEXT 


<RETURN> 


KEYIN ESC II '9' IS CMD 1 1 ' LOCATION L IS 


THAT' 1 ICR "<SHIFT-F4> 




KEYIN ESCII'8' IS CMDII'COPY STRING " 


' ' OVER REPEAT SELECT ' " " 


1 I; 


'%V(27)%V(13)%V(27)V"%V(18)%V(27)>' 


"SUBSTITUTE <F4> 





Figure C-5. VIP7801/VIP7802 Context File 
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Figure C-6 illustrates the context file for the Zenith Z19 terminal. The name 
of this file is: 



:6EDIT CONTEXT ZENZ19. : LIBRARY 



" Standard synonyms and values 

SYNONYM REKEY IS COPY CURRENT OVER CURRENT 
SYNONYM EACH IS REPEAT SELECT RECORD SELECT 



SYNONYM SHL 
ESC EQ 



IS 



DELETE REPEAT SELECT RECORD SELECT BO RECORD THRU POSITION 
; CR EQ '7o\J(^3)' 
input activation characters for 6Edit 
CMD EQ 'XVCS)' 

" Cursor movement keyins 

ESCI I 'A' IS ESCI I 'A' 
ESCI I 'B' 

CMD I I 'BACKWARD SKIP 8 BO 



KEYIN 
KEYIN 
KEYIN 



'%V(27) 
Special 



ESCI I 'B' 
ESCI I • ! • 



IS 
IS 



<Up Arrow> 
<Down Arrow> 



KEYIN ESC 
"KEYIN IS 



rr 

CMD I 



KEYIN 
KEYIN 
KEYIN 
KEYIN 
KEYIN 
KEYIN 



ESCI! '2' 
ESC 1 I 'V 



"BACKWARD 1 
"FORWARD 1 
RECORDS' I ICR 

"BACKWARD 8 <ESC> <!> 
IS CMDII'SKIP 8 BO RECORDS' I ICR "FORWARD 8 <ESC> <1> 
'BACKWARD SKIP 20 BO RECORDS' NCR" 

"BACKWARD 20 <F1> BA SK 20 RE <RETURN> 
'SKIP 20 BO RECORDS' I ICR "FORWARD 20 <ESC> <2> 
•BACKWARD SKIP 1 ""%V(8)' "BACKWARD PATTERN <F4> 



IS 

IS 



CMD I 

CMD I 
CMD! 



•SKIP 1 "• 
'p.n rMRDcwT 



'%y(8) 

• ! ! fP 



ESC I I 'F' IS CMDI I 'EO CURRENT' 
ESCI I • . ' IS CMDI I 'L' I ICR 
Block editing keyins 



ICR 



KEYIN ESC I I 'S' 
KEYIN ESC I I 'H' 
KEYIN ESCI I 'T' 
KEYIN ESCI I 'R^ 
KEYIN ESCI I 'P' 
KEYIN ESCI I '3' 
KEYIN ESC I I •#• 
KEYIN ESCI I •A^ 
KEYIN ESCI I '$' 
KEYIN ESC I I 'Q' 
"KEYIN IS CMDI 
KEYIN ESCI I 'E' 
KEYIN ESC I I '_' 
KEYIN ESCI I •[' 
KEYIN ESCI I ']' 
KEYIN ESCI I •: ' 
KEYIN ESC I I 'U^ 



IS 
IS 
IS 
IS 
IS 
IS 
IS 
IS 
IS 
IS 



CMD 

CMDI I •THRU' I ICR 
CMDI I 'ADJUST' I ICR 
CMDI I 'COPY THAT' I ICR 



CMDI I 'MOVE 
CMDI I 'COPY 
CMDI I 'MOVE 
CMDI I 'COPY 
CMDI I 'MOVE 
CMDI I 'AFTER 



THAT' I ICR 
RECORD' I ICR 
RECORD' I ICR 
L AFTER HERE' I ICR 
L AFTER HERE' I ICR 
HERE' I ICR 



'OVER THAT' I ICR" 

IS CMDI I 'DELETE THAT' I ICR 

IS CMDI I 'EDIT THAT' I ICR 

IS CMDI I 'EDIT PREVIOUS' I ICR 

IS CMDI I 'EDIT NEXT' I ICR 

IS CMDI I 'LOCATION L IS THAT' 

IS CMDI I 'COPY STRING ' ' 



"FORWARD PATTERN <F5> 
"<ESC> <0> 
"<ESC> <F> 
"<ESC> <-> 

"<F1> 
"<Home> 
"<F2> 
"<6ray> 
"<Blue> 
"<ESC> <3> 
"<ESC> <ff> 
"<ESC> <4> 
"<ESC> <$> 
"<Red> 

"<F1> OV THAT <RETURN> 
"<SHIFT-ERASE> 
"<ESC> < > 



•%V(27)%V(13)%V(27)V"%V(18)%V(27)>' 



"<ESC> <[> 
"<ESC> <]> 
ICR "<ESC> <:> 
OVER REPEAT SELECT " ' " 
"SUBSTITUTE <F3> 
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Table C-2 describes the definitions for common functions of the context files 
Listed in this appendix supported by 6Edit. These function descriptions apply 
to each context file; their key invocations differ, depending on the terminal 
used. Refer to the appropriate figure in this appendix for the key strokes 
corresponding to that context file. 



Table C-2. Common Functions Defined By a Context File 



Function Description 



ADJUST 

Move the cursor to the other end of the block currently being 
selected. If you type the ADJUST function repeatedly, the 
cursor bounces back and forth from one end of the current 
selected block to the other. While the cursor is at an end of 
the selected block, moving the cursor changes the 
specification of the block. 



AFTER HERE 

Insert the source block at the current cursor location. You 
must have set the source block previously with some COPY or 
MOVE command. 



BACKWARD 8 RECORDS 

Move the cursor backward (up) 8 records. 



BACKWARD 20 RECORDS 

Move the cursor backward 20 records. 



Backward Pattern Search 

Search backward for a match of a pattern. This resembles the 
Pattern Search key, searching backward in the file from the 
current cursor location. 
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Table C-2. Common Functions Defined By a Context File (cont) 

Function Description 

BO CURRENT 

Move the cursor to the beginning of the current edit block. 



Command Window 

Move the cursor to the command window. 



COPY L AFTER HERE 

Insert the block named L at the current cursor Location. You 
should have given a block the name L previously, using the 
LOCATION command. 



COPY RECORD 

The record on which the cursor is sitting becomes the s 
block for the next AFTER/OVER command. 



COPY THAT 

The selected block becomes the source block for the next 
AFTER/OVER operation. Before typing the COPY key you should 
select a block of data. (See Section 1, Overview of 6Edit, 
subsection 'Specifying a Block.') 



DELETE THAT 



Delete the selected block. Before typing the DELETE key you 
should select the block of data to be deleted. 
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Table C-2. Common Functions Defined By a Context File (cont) 



Function Description 



EDIT NEXT 

EDIT NEXT advances you to the next edit block. This allows 
you to refer to the block specification following your current 
edit block. 



EDIT PREVIOUS 

EDIT PREVIOUS restores the old edit block from a previous EDIT 
command. This becomes the new edit block. EDIT THAT and EDIT 
PREVIOUS can be used together to make editing easier. 

For example, to change all occurrences of "giraffe" to "horse" 
only in a specific group of records, use the following 
procedure: 

o Select the group of records: move the cursor to the 
beginning of the first record in the group, type THRU, 
then move the cursor to the beginning of the record after 
the last record in the group. 

O Type EDIT THAT. 

o Type the Substitute key, (see below), fill in the new and 
old strings, and perform the operation. 

0 Type EDIT PREVIOUS. 



EDIT THAT 

The selected block becomes the new edit block. 6Edit 
remembers the old edit block so it can restore it later. The 
selected block must begin and end at the beginning of the 
records you want to include in the new edit block. This key 
is useful before using the Substitute key to limit the string 
substitutions to the records in the selected block. 
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Table C-2. Common Functions Defined By a Context File (cont) 



Function Description 



EO CURRENT 

Move the cursor to the end of the current edit block. 



FORWARD 8 RECORDS 

Move the cursor forward (down) 8 records. 



FORWARD 20 RECORDS 

Move the cursor forward 20 records (about a screen-f uL L ) . 



Move to L 

Move the cursor to the block named L. You should have 
previously located a block, giving it the name L. This is 
done with Location L function. Having named a block L, you 
can return to it at any time (in the same editing session) 
using L. 



LOCATION L IS THAT 

Gives the name L to the location of the selected block. 



MOVE L AFTER HERE 

Insert the block named L at the current cursor location. This 
is the same as the "COPY L AFTER HERE" key except that after 
inserting the block at the cursor location the block named L 
is deleted. (Note that after this deletion, the name L still 
refers to the same location in the file.) You should have 
given a block the name L previously, using the LOCATION 
command. 
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Table 


C-2. Common Functions Defined By a Context File (cont) 


Funct ion 


Descr ipt ion 


MOVE 


RECORD 


The record on which the cursor is sitting becomes the source 
block for the next AFTER/OVER command. Also, after performing 
the next AFTER/OVER command, 6Edit deletes this record. 


MOVE 


THAT 


The selected block becomes the source block for the next 
AFTER/OVER operation. This is the same as the COPY key, 
except that after the next AFTER/OVER operation the source 
block is deleted. 


OVER 


THAT 


Replace the selected block with the source block. Before 
typing the OVER key you should select the block of data which 
is to be replaced. 


Pattern Search 






Search forward for a match of a pattern. When you type the 
Pattern Search key, the cursor moves to the command window, 
and the one of following message displays appears. 






0 The message 






SKIP 1 " 






appears and the cursor moves to the second apostrophe ('), 
ready for you to type a pattern string. After you have 
typed the pattern string, press the Return key. 






0 Or, the message 






Pattern string: 






appears; you type the pattern string and press the Return 
key. 
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Table C-2. Common Functions Defined By a Context File (cont) 



Function Description 



6Edit searches for the pattern, moving forward in the file 
from the current cursor Location. If 6Edit finds a match, it 
places the cursor on the match and fills the screen with data 
from the area of the file surrounding the match; if 6Edit does 
not find a match, it does not move the cursor from its 
location when the Pattern Search key is typed. 

If you want to search for the same pattern string that was 
used in the last pattern search, just type Return immediately 
after typing the Pattern Search key. This enters an empty 
pattern string, which tells 6Edit to use the last pattern 
string typed. 



THRU 

Type this key when the current cursor location is the 
beginning of a block of data you want to select. This block 
becomes the selected block. To complete the selection after 
typing the THRU key, move the cursor to the end of the block 
you want to select. At that time, you can either: 

Type a key which performs some operation with the selected 
block, such as COPY, DELETE, AFTER, or LOCATION, or 

move the cursor to the command window, and enter an editing 
command. In the command, you can use the predefined name THAT 
to refer to the selected block, the block of data which you 
just selected. 



Subst i tute 

Substitute a string for all pattern matches. When you type 
this key, the cursor moves to the command window, and one of 
the following displays occurs. 

o The message 

COPY STRING " OVER REPEAT SELECT PATTERN " 
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TabLe C-2. Common Functions Defined By a Context File (cont) 



Function Description 



appears with the cursor on the second apostrophe ('), 
ready for you to type a replacement string for aLL pattern 
matches. You can also type a pattern string between the 
second pair of apostrophes (*'). 

o Or, the message 

New string: 

appears; you then type the new string and press the Return 
key. Then 6Edit displays the message: 

Old string: 

to which you enter the old string and press the Return 
key. 

This key can be used to replace all matches of a pattern 
string with a different string. 

You do not have to type a pattern string if the Last pattern 
you searched for is the one you want to use for the 
substitution operation. 

The replacement is done over the remainder of the edit block, 
from the current cursor location to the end of the edit block. 

If you want to Limit the replacement to some block of data in 
the file, insert the specification of that block between the 
keywords OVER and REPEAT. 



Example: 

COPY STRING 'xyz' OVER REPEAT SELECT PATTERN 'abc' 

replaces the remaining occurrences of the string "abc" with 

the replacement string "xyz". 

COPY STRING 'xyz' OVER THAT REPEAT SELECT PATTERN 'abc' 
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Table C-2. Common Functions Defined By a Context File (cont) 



Function Description 



Limits replacement to the current selected block. You can 
specify the selected block (prior to typing the Substitute 
key) by moving the cursor and using the THRU key or the ADJUST 
key. (See Section 1, Overview of 6Edit.) 

COPY STRING 'xyz' OVER 10 THRU 20 REPEAT SELECT PATTERN 'abc' 

searches between records 10.0 and 20.0; in that range, it 
replaces all appearances of "abc" with "xyz". 

COPY STRING 'xyz' OVER SECTI0N_4 REPEAT SELECT PATTERN 'abc' 

assumes that you have created a name "SECTI0N_4" with the 
LOCATION command; it limits replacement to the block of data 
which you located as "SECTI0N_4". 
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Appendix D 

Customizing the 6Edit User Interface 



As you become more familiar with 6Edit, you might want to tailor a context 
file to better address your particular needs. This appendix outlines some 
fundamentals to consider before you begin. 



Reasons to Customize 

Several reasons warrant designing an alternate context file for 6Edit. You 
might want to: 

0 Adapt 6Edit to different keyboards. The key layout would differ. 

o Adapt 6Edit to different uses. Different functions would be more 
important than others, and thus easier to use regularly. 

0 Adapt 6Edit to different users. Users have different backgrounds, needs, 
and preferences. 

You can design a new context file based on any or all of the above. Design 
several different context files first for different combinations of needs. 
For example, design a context file for terminal "x", for function "y", and for 
user "z". Then design the same file for user "q", addressing various factors 
until you find the right combination. 

You should be familiar with each consideration before designing a new context 
file. Ask yourself questions about each to determine exactly what to include, 
and what to omit. 



Customizing: Know the Keyboard 
o Does it have function keys? 

If so, are they conveniently placed? How far must a hand move to press 
each one? Are the function keys touch-typed? Are they arranged within a 
keypad, all typed from a single hand position; or are they arranged in 
rows, typed by moving the hand position and redirecting the eyes? Must 
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the shift key be engaged to invoke a function key? Must the keys be 
Labeled? On CP-6, many keys which are not normally considered function 
keys can be treated as such, since their meanings can be redefined. For 
example. Linefeed, home, and delete are used as already-Labeled function 
keys . 

o Is the Control key accessible? 

Is it easy to use? With which keys can it be used easily; with which keys 
must the hand reach? 

o Is the Escape key accessible? 

Is it easy to use? Usually a two-key sequence is easier to use when the 
second key is pressed by the opposite hand. 

0 Are other special keys accessible? 

Are delete, backspace, return, tab, break, and arrow keys easy to use? 
Some keyboards place the delete key near letter keys; touch typists can 
easily reach it there. Other keyboards place the delete key away from the 
other keys; some easier-to-reach key may perform the "delete character" 
function instead. 



Customizing: Know the Functions Required 

0 Are the data stream-oriented, or structured? 

Document files are mostly stream-oriented, represented as a stream of 
characters to be formatted later. Computer programs are more structured; 
the data in each record are indented in a significant way. For computer 
programs, it is more important to be able to manipulate records. For 
documents, it is more important to manipulate sentences and paragraphs. 

o Are the data fixed-form (i.e. tables), or free-form? 

0 Will users change existing file data, or add data to files? More 
functions are needed to be able to easily change existing data. 

0 Will there be much inter-file copying? 

Will users want to view or edit more than one file at a time? If so, 
inter-file functions become more important. 
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o How is each function generally viewed? 



Large-scale or small scale? Positioning or editing? What is the unit of 
data on which each function operates? Character, word, sentence, 
paragraph, chapter, document; or character, word, record, procedure, 
module? 



Customizing: Know the Users 

o Do the users use only one type of terminal, or do they switch between 
terminal types regularly? Are most users touch typists? If so, hand 
position is an important consideration when designing a context file. 

0 To what system and editor are the users accustomed? 

To CP-6? To another editor? To another operating system? If users are 
accustomed to another system or editor, you may want to note how they 
invoke common functions on terminals with which they are familiar. Then, 
make 6Edit respond similarly when users type old keys and sequences out of 
habit. This will save learning and re-learning time, and reduce errors. 

o How often will the users use 6Edit? 

Frequently? Then performance is important. Casually? Then learning, 
remembering, and using the processor are important. 

o How knowledgeable are the users? 

Do they know computers, jargon, and concepts such as files, records, and 
record keys? Do they know CP-6 and its capabilities? Do they know 
editors in general? Are they accustomed to making file transformations in 
a computer-based, editor-based way, or in a typewriter way? Do they know 
a specific editor? Is their editing knowledge biased? 

These parameters indicate how users feel about editing tasks. If they have 
never used a computer-based editor before, you might want to emphasize 
typewriter analogies in the context file. If they know a different system, 
you might pinpoint similarities between CP-6 and 6Edit concepts, and similar 
concepts in the old system. 
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Invoking Functions 

There are three basic ways to invoke functions in 6Edit. 

o Using the KEYIN command, you can bind a function to a key or key sequence. 
(For more information regarding the KEYIN command, see Section 3, 6Edit 
Commands . ) 

You must account not only for the type of key in question, but for the 
number of keystrokes necessary for each key, the hand position, and 
whether the key is Labeled on the terminal. For example: 

Type of number of hand 

Key/Sequence keystrokes position labeled? 



Function keys 1 lost usually 

Shifted function keys 1.5 lost usually 

Alternate-function keys 1.5 lost usually 

Control-function keys 1.5 lost usually 

Control key 1.5 kept yes 

Escape sequence 2 may be kept yes 

Escape shift sequence 2.5 kept no 

When invoking functions, note the following points: 



o Defining a key sequence to be immediate-type in one window, but 

typeahead-type in another window may give unpredictable results. Either 
key sequence definition could be used by the FEP, depending on where 6Edit 
is in its processing of the last terminal input. 

o Typing an immediate-type function before 6Edit has IMPed the key sequence 
to a typeahead-type function, invokes an immediate-type function. 

For additional information about these points, see the KEYIN command. 

o Using the SYNONYM command, you can define a synonym for a command keyword, 
part of a command, or several commands. The user remembers the synonym 
more easily than a command. It is also easier to type. (For more 
information regarding the SYNONYM command, see Section 3, 6Edit Commands.) 
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0 A simple command is the most flexible means of invoking a function. It is 
usually more difficult to remember and type, since there are more 
keystrokes involved. 



Invoking Functions on a Personal Computer 

A PC used with the PC Terminal Facility (PCT) and the default PCT key 
definitions sends two-character sequences for individual function keys (Fn) F1 
through F10, shifted function keys (SFn) F1 through F10, alternate function 
keys (Alt-Fn) F1 through FA, and the cursor control (including Home) keys; and 
sends three-character sequences for the Ins and Backtab (shifted Tab) keys. 
These can be defined in 6Edit using the KEYIN command (optionally with the 
$KEY predefined string function). 

The character sequences sent by PCT are interpreted by the FEP based on KEYIN, 
IMP, and built-in definitions and on the terminal profile, with the results 
returned to 6Edit. (See Section 3, 6Edit Commands, for more information on 
KEYIN. See the CP-6 PC Terminal Facility Reference Manual, HA15, for more 
information on PCT.) 

To use the full sets of one-and-a-half-stroke alternate and control function 
keys (Alt-Fn and Cntl-Fn) with 6Edit KEYIN definitions, the PCT.CMD file must 
exist on your PC and must have the alternate and control keys defined in the 
following form: 

DEF A-Fn "$[[(n-1)$?$ (for alternate function keys) 

DEF C-Fn "$[[(n-1)-'$ (for control function keys) 

where n is the number of the function key. For example, Alt-F5 would be 
defined in PCT.CMD as DEF A-F5 "$[[4$?$. Note that while you can define the 
keys differently in PCT, the following discussion is based on these 
definitions and will work only with them, because they correspond to the 
definitions contained in the CP-6 profiles for PCT (PCT\/7800 and PCTX36A). 

The alternate and control function keys defined in the PCT.CMD file as above 
cause the PC to send four-character sequences, as follows: 

ESC [ n DEL (for alternate function keys) 

ESC [ n - (for control function keys) 

where n is one less than the number on the function key. 
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These four-character sequences exceed the three-character Limit on the key 
name ( str ing_expression_1 ) parameter of the KEYIN command. But the following 
two variations of the $KEY function permit you to use them: 

$KEY(SUn) (for alternate function keys) 

$KEY(UFn) (for control function keys) 
where n is the number of the function key. 
For example: 

KEYIN $KEY(SU5) IS ' %V(27)5R%V( 23) ' 

defines the Alt-F5 key sequence to move the cursor left by one word. 
KEYIN $KEY(UF5) IS •%V(27)5S%V(23) ' 

defines the Cntl-F5 key sequence to move the cursor right by one word. 

For variations of the above examples for different key sequences (and 
additional explanations), see the KEYIN command in Section 3. 

Note that introducer characters (set by the $INTR0_1 and $INTR0_2 predefined 
names) are not required with the SUn and UFn forms of $KEY. 

Associating Functions with Invocations 

There are three ways to associate functions with keys: 
Estab i i shed Assoc i at i on 

This method takes advantage of an invocation or function association already 
familiar to users. For example, if the users have worked on CP-6 before, they 
know that the Escape N function moves the cursor to the end of the record. If 
they are familiar with computers, they know that in ASCII, the Control-H 
function means backspace. If they know a different editor, they may know how 
to invoke a function similar to a 6Edit function, using another editor's 
sequence. 
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Mnemon i c Assoc i at i on 

This method employs a mnemonic relationship between the name of a function and 
the key or sequence used to invoke it. For example, the user types <CNTL-R> 
for "move right," or <ESC> <B> for "move to the beginning of file." 



Physical Association 



This method uses a correlation between the physical relation of two keys or 
sequences on the keyboard, and the Logical relation of two functions. There 
are three types of physical/Logical relations: 



o Spectrum of scale relations: 



You can allocate certain parameters for certain key operations. 
For example: 



Control key: small scope 

Esc sequence or function key: medium scope 
shifted Esc sequence key, or 

shifted function key: large scope 



Thus, use Escape 1 for "skip 1 Line", and Escape shift 1 for "skip 1 
page". Or, use function key 1 for "copy record", and shifted function key 
1 for "copy block" or "copy file". 



o Direction on keyboard: 



The direction on the keyboard can imply the direction in the file. For 
example, type <CNTL-W> to "move Left 1 word," and <CNTL-E> to "move right 
1 word." Type <ESC> <W> to "move up 8 Lines," and <ESC> <A> to "move down 
8 lines." 



o Combine the above. For example: 



<CNTL-W> move left 1 word 

<CNTL-E> move right 1 word 

<ESC> <W> move up 8 Lines 

<ESC> <E> move down 8 lines 



CE70-02 



Customizing the 6Edit User Interface 



D-7 



Hazards 

Avoid conflicts with global or system-wide associations. Escape D and 
Control-X are useful in all CP-6 programs. They should not be redefined 
unless users will not need the standard CP-6 functions. XON and XOFF 
(ControL-Q and Control-S) are needed for flow control on certain terminals. 
Do not redefine or use them at all on these terminals. 



Avoid erroneous associations: 



o Established associations: If users depend on Escape Q to signify status 
when not using 6Edit, you should not define <ESC> <Q> to mean "delete 
file." 



0 Mnemonic associations: Escape D or Control-D could be mnemonically 
associated with either "down" or "delete." 



o Physical associations: When reaching for <CNTL-X> to delete a line, it is 
easy to accidentally hit <CNTL-Z> or <CNTL-C>. Do not place drastic 
functions near safe functions. 



o Many terminals react to certain control characters in such a way that you 
cannot redefine the control character, and should not even type the 
control character on those terminals. Control characters to be aware of 
include: 



<CNTL-Q> and <CNTL-S> 



XON and XOFF; used for flow control on many terminals. 



<CNTL-P> 



Used by many communications networks; avoid it if your terminal is 
connected to the CP-6 system via a commercial communications service. 



<CNTL-E> 



ACK; many terminals respond to this key by sending miscellaneous 
characters to the system. 

0 When KEYINing a key sequence (either user-defined or built-in) which is 
defined to be immediate-phase outside of 6Edit, NEVER use an IN-clause 
("IN COMMAND" or "IN EDITING"); this would create the dangerous situation 
where the key sequence is defined to be an immediate-phase function in one 
of 6Edit's windows, and a read-phase function in the other 6Edit window. 
Such a situation causes the FEP to act in ways which, are unpredictable and 
confusing to users. 
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Appendix E 

Input Editing Functions 



This appendix Lists aLL input editing functions available in 6Edit. It 

assumes that you have not redefined any of the keys on your terminal keyboard. 

These functions are executed by the Front End Processor (FEP). (For more 
information on Input Editing Functions, see Section 2, Using 6Edit.) 



Table E-1. Input Editing Functions 



Name Function 



<ESC> <A> 

When the cursor is in the 6Edit editing window: move the 
cursor up one record. When the cursor is in the 6Edit command 
window: toggle pagehalt. (Note, however, that 6Edit 
continuously toggles pagehalt in the command window 
automatically, overriding your selection.) In the editing 
window only: <ESC> <n> <A> moves the cursor up "n" records. 
The n parameter is any 1 or 2 decimal digits. 



<ESC> <B> 

In the 6Edit editing window: move cursor down one record. In 
the 6Edit command window: simulate Break function. In the 
editing window only: <ESC> <n> <B> moves the cursor down "n" 
records. The n parameter is any 1 or 2 decimal digits. 



<ESC> <CNTL-B> 

Simulates the Break function. Does not delete typeahead. 
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Table E-1. Input Editing Functions (cont) 



Name Function 



<ESC> <C> 

In the 6Edit editing window: move cursor right one position 
(same as <CNTL-R>). In the 6Edit command window: toggles 
relative tabbing mode. In the editing window only: <ESC> <n> 
<C> moves the cursor right "n" positions. The n parameter is 
any 1, 2, 3, or 4 decimal digits. 



<ESC> <D> 

In the 6Edit editing window: move cursor Left one position 
(same as <BS>). In the 6Edit command window: recalls the Last 
saved input record. In the editing window only: <ESC> <n> <D> 
moves the cursor left "n" positions. The n parameter is any 1, 
2, 3, or 4 decimal digits. 



<ESC> <CNTL-D> 

Recall last input saved in command or IBEX window. 



<ESC> <n> <E> 

Position to the top, middle, or bottom of the window for n less 
than, equal to, or greater than one, respectively. 



<ESC> <G> 

Display FEP information. 



<ESC> <H> 

Halt output immediately. Type <CR> to resume output. 
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Table E-1. Input Editing Functions (cont) 


Name 




Function 


<ESC> 


<n> 


<H> 






Set HSSHIFT (the number of columns that an input image is to be 






shifted) to the value n. For this sequence to work, the 






SHSCROLL predefined name must be set non-zero. 


<ESC> 


<I> 








Simulate Tab. 






<ESC> <n> <I> moves the cursor to position "n" of the current 






record. <ESC> <-> <I> moves the cursor to the previous tab 






stop. The n parameter is any 1, 2, 3, or 4 decimal digits. 


<ESC> 


<J> 








Define or reset the insertion window. 


<ESC> 


<K> 








Delete record (or insertion window) to right of cursor. 


<ESC> 


<CNTL-K> 






Delete record (or insertion window) to left of cursor. 


<ESC> 


<CNTL-L> 






Delete record, leaving the cursor at the next record. 


<ESC> 


<M> 








Set replacement mode. Resets overstrike and insertion mode. 
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Table E-1. Input Editing Functions (cont) 



Name Function 



<ESC> <n> <M> 

Set HSMAR6IN (the closest the cursor is to be allowed to 
approach the end of an input area) to the value n. For this 
sequence to work, the SHSCROLL predefined name must be set 
non-zero. 



<ESC> <N> 

Move cursor to the end of record (or insertion window). 



<ESC> <0> 

Set overstrike mode. Resets replacement and insertion modes. 



<ESC> <P> 

Recall record as it was when the cursor was last moved onto 
record. This function is only available in the 6Edit editing 
window. <ESC> <n> <P> copies the nth record below the current 
record over the current record. 

<ESC> <n> <-> <P> copies the nth record above the current 
record over the current record. The n parameter is any 1 or 2 
decimal digits. 



<ESC> <Q> 

Display system status. 



<ESC> <R> 

Retype record; reset insertion window. 

<ESC> <n> <R> resets the parameter identified by "n" (turns off 
the parameter). The n parameter is any 1 or 2 decimal digits. 
The table below lists the values for n: 
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Table E-1. Input Editing Functions (cont) 



Name Function 



n Meaning 



1 Autotab mode (see $AUTOTAB in Appendix A). 
Can only be used to disable autotabing. 
Setting this parameter (via <ESC> <1> <S>) or 
toggling the parameter on (via <ESC> <1> <T>) 
has the same effect as <ESC> <1> <R> ~ 

the parameter is reset. 

2 Insert mode (see SINSERT in Appendix A). 

3 Message line for operator messages. 

4 Wordwrap mode (see SWORDWRAP in Appendix A). 

Can only be used to disable wordwrap mode. Setting 
this parameter (via <ESC> <A> <S>) or toggling 
the parameter on (via <ESC> <A> <T>) has the same 
effect as <ESC> <4> <R> — the parameter is reset. 

5 Search to the right. Establishes the direction for 
word and character searches. 

6 Truncate mode (see the IBEX TERMINAL command). 

7 Actontrn (see the IBEX TERMINAL command). 

8 Wordwrap toggle (see SWORDWRAP in Appendix A). 
Resetting this parameter disables wordwrap mode 
but remembers the column. Setting this parameter 
enables wordwrap mode at the remembered column. 

9 Recordwrap mode (see SRECORDWRAP in Appendix A). 

10 Textedit mode. Attempts to preserve spaces 
between words when splitting and joining records. 

11 Easyappend. Allows records to be appended to the 
end of the file simply by moving the cursor down 
past the end-of-file position. 

12 Changecase. Makes forward cursor movement change 
the case of the characters under it. 

13 Parkcursor. Moves the cursor to the window's home 
position when activation occurs in screen-editing 
mode. 

The following values of "n" are only available in the command 
window: 
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Table E-1. Input Editing Functions (cont) 


Name 


Function 






n 


Meaning 






— 
20 


Over strike mode 






21 


Echo 






22 


Par itycheck 






23 


Outputdiscard 






24 


Uppercase 






25 


Apl Icnrm 






26 


Retypovr 






27 


Editovr 






ci 


Pagena L t 






30 


Printhalt 






31 


Relpage 






32 


S imper 






33 


Noopt imiz 






34 


Wrappage 






35 


LocaLech 






36 


Messagehalt 






37 


Autocursor 






38 


Truovrprt 






39 


Cursorread 






40 


Keeptypahd 






See the 


IBEX TERMINAL command for descriptions of 


these 




parameters. 






The foLLowing values of "n" are available only in 


the command 




window. 


and when FCNTBL=CP5: 






n 


Meaning 






50 


Tabs im 






51 


Tabrelat i ve 






52 


Spaceinsert 






53 


Lowercase 






54 


Fullduxpapertape 






55 


Halfduxpapertap 






See the 


IBEX TERMINAL command for descriptions of 


these 




parameters. 
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Table E-1. Input Editing Functions (cont) 



Name Funct ion 

<ESC> <CNTL-R> 

Reset insertion window. 



<ESC> <n> <S> 



Sets the parameter identified by "n" (turns on the parameter). 
The n parameter is any 1 or 2 decimal digits. See <ESC> <R> 
for the table of values for n. 



<ESC> <n> <T> 



Toggles the parameter identified by "n". If the parameter was 
set, it will be reset; if it was reset, it will be set. The n 
parameter is any 1 or 2 decimal digits. See <ESC> <R> for the 
table of values for n. 



<ESC> <U> 



Toggle uppercase restriction, 



<ESC> <V> 

Search record (or insertion window) for character 



<ESC> <CNTL-W> 



Delete word, beginning with the character under the cursor, and 
proceeding to the right, up to the beginning of the next word. 



<ESC> <X> 



Erase contents of record, 
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Table E-1. Input Editing Functions (cont) 


Name 




hunct ion 


<ESC> 


<Y> 


Monitor attention. 


<ESC> 


<•> 


Set insertion mode. Resets overstrike and replacement modes. 


<ESC> 


<*> 


Save contents of the insertion window. 


<ESC> 


<: > 


Recall the data saved by the last <ESC> <*> function. 


<ESC> 


<-> 


When more than one session has been started on this terminal, 
<ESC> <.> moves the cursor to the next session reading from the 
terminal . 


<ESC> 


<(> 


Enter lowercase shift. 


<ESC> 


<)> 


Exit lowercase shift. 
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Table E-1. Input Editing Functions (cont) 



Name Function 



<ESC> <-> 

Redisplay entire editing window. This function is only 
available in the 6Edit editing window. 



<ESC> <» and «> 

Set limits of insertion window. 



<ESC> 

Set wordwrap column. 

<ESC> <n> <'^> sets the wordwrap mode column to position "n". 
The n parameter is any 1, 2, 3, or 4 decimal digits. For 
example, <ESC> <8> <'^> sets the wordwrap column to position 8. 
(See Section 2.) 



<ESC> <BS> 

If cursor is at beginning of record, join record to previous 
record. If cursor is at end of record, join next record to 
current record. This function is only available in the 6Edit 
editing window. 



<ESC> <HT> 

Set autotab column. 

<ESC> <n> <HT> sets the autotab column to position "n". The n 
parameter is any 1, 2, 3, or 4 decimal digits. (See predefined 
name SAUTOTAB in Appendix A.) 
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Table E-1. Input Editing Functions (cont) 



Name hunciion 



<ESC> <CR> 

Move cursor to beginning of record (or insertion window). 



<ESC> <LF> 

In the 6Edit editing window: split record, inserting the 
portion of the record to the right of the cursor as a new 
record to follow the current record. In the 6Edit command 
window: local linefeed. 

In the editing window only: <ESC> <2> <LF> will fill or 
shorten the current record to the wordwrap column. If the 
record is shorter than the wordwrap column, words from the next 
record will be moved onto the current record. If the record is 
longer than the wordwrap column, it will be split near the 
wordwrap column. (See predefined name SWORDWRAP in Appendix 
A.) 

In the editing window only: <ESC> <1> <LF> will perform the 
<ESC> <2> <LF> actions repeatedly until the cursor reaches the 
next paragraph, or the bottom of the editing window. 



<ESC> <ESC> 

Monitor attention (same as <ESC> <Y>). 



<ESC> <DEL> 

Delete the character to the left of the cursor; if at the 
beginning of record, do nothing. 

If the recordwrap mode is set and the cursor is at the 
beginning of the record, acts like <ESC> <BS>. It joins the 
current record to the previous record. (See SRECORDWRAP in 
Appendix A). 
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Table E-1. Input Editing Functions (cont) 



Name Function 



<CNTL-H> 

(BS) 

Move cursor Left one position; if at the beginning of record, 
action depends on the record wrap mode (see SRECORDWRAP in 
Appendix A). If the record wrap mode is disabled (the initial 
setting) or the cursor is in the command window, <CNTL-H> when 
at the beginning of a record does nothing. If the record wrap 
mode is enabled and the cursor is in the editing window, 
<CNTL-H> when at the beginning of a record moves the cursor to 
just beyond the end of the previous record. 



<CNTL-I> 

(TAB) 

Move cursor to the next tab stop. Extend record if necessary. 



<CNTL-J> 

(LF) 

In the 6Edit editing window: move cursor down one record (same 
as <ESC> <B>). In the 6Edit command window: activates a 
command entry. 



<CNTL-M> 

(CR) 

In the 6Edit editing window: move cursor to the beginning of 
the next record. If at the end of the file, append a 
zero- Length record to the file. In the 6Edit command window: 
activates a command entry. 



<CNTL-R> 

(DC2) 

Move cursor right one position; if at the end of record, action 
depends on the record wrap mode (see SRECORDWRAP in Appendix 
A). If the record wrap mode is disabled (the initial setting) 
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Table E-1. Input Editing Functions (cont) 


Name 




Funct ion 


or the cursor is in the command window, <CNTL-R> when at the 
end of a record appends a space character to the record. If 
the record wrap mode is enabled and the cursor is in the 
editing window, <CNTL-R> when at the end of a record moves the 
cursor to the beginning of the next record. 


<CNTL- 


U> 


(NAK) 

Move cursor right one character, changing the case of the 
character under the cursor. 


<CNTL- 


X> 


(CAN) 

Same as <ESC> <X>, but acts immediately. (Also deletes 
typeahead and queued output.) 


<CNTL- 


W> 


(ETB) 

Move cursor to the next or previous word, depending on current 
direction, set by the last <BS> or <CNTL-R>. 


<CNTL- 


Y> 


(EM) 

Monitor attention. (Also deletes typeahead and queued output.) 


<DEL> 




Delete character under cursor. If in the replacement mode and 
at end of record (or insertion window), delete character to 
left of cursor; if in the insertion mode and at end of record 
(or insertion window), <DEL> is ignored. 
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Table E-1. Input Editing Functions (cont) 


Name 


Funct ion 


<BREAK> 






Interrupt program. 
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Appendix F 

The ASCII Character Set 



This appendix presents the ASCII character set. 





Table F-1. The ASCII 


Character Set 


ASCII NAME 


CHARACTER ENTRY 


DECIMAL CODE 


NULL 


<CNTL-S)> 


0 


SOH 


<CNTL-A> 


1 


STX 


<CNTL-B> 


2 


ETX 


<CNTL-C> 


3 


ECT 


<CNTL-D> 


4 


ENQ 


<CNTL-E> 


5 


ACK 


<CNTL-F> 


6 


BEL 


<CNTL-G> 


7 


BS 


<CNTL-H> 


8 


HT 


<CNTL-I> 


9 


LF 


<CNTL-J> 


10 


VT 


<CNTL-K> 


11 


FF 


<CNTL-L> 


12 


CR 


<CNTL-M> 


13 


SO 


<CNTL-N> 


14 


SI 


<CNTL-0> 


15 


DLE 


<CNTL-P> 


16 


DC1 


<CNTL-Q> 


17 


DC2 


<CNTL-R> 


18 


DC3 


<CNTL-S> 


19 


DC4 


<CNTL-T> 


20 


NAK 


<CNTL-U> 


21 


SYN 


<CNTL-V> 


22 


ETB 


<CNTL-W> 


23 
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Table F-1. The ASCII 


Character Set (cont) 


ASCII NAME 


CHARACTER ENTRY 


DECIMAL CODE 


CAN 


<CNTL-X> 


24 


EM 


<CNTL-Y> 


25 


SUB 


<CNTL-Z> 


26 


ESC 


<CNTL-[> 


27 


FS 


<CNTL-\> 


28 


6S 


<CNTL-]> 


29 


RS 


<CNTL-"> 


30 


US 


<CNTL-_> 


31 


SP 


< > 




J 


<!> 


33 




<"> 


34 




<#> 


35 


$ 


<$> 


36 


% 


<%> 


37 


& 


<&> 


38 


' 


<•> 


39 


( 

v 






) 


<)> 


/. 1 
t 1 


★ 


<*> 


42 


+ 


< + > 


43 


1 


<•> 


44 


- 


<-> 


45 




<.> 


46 


/ 


</> 


47 


0 


<0> 


48 


1 


<1> 


49 


2 


<2> 


50 


3 


<3> 


51 


4 


<4> 


52 




<5> 


53 


6 


<6> 


54 


7 


<7> 


55 
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Table F-1. The ASCII 


Character Set (cont) 


ASCII 


NAME 


CHARACTER ENTRY 


DECIMAL CODE 


o 

0 




<o> 


JO 


9 




<9> 


57 






<: > 


58 


r 




<;> 


59 


< 




«> 


60 


- 




<=> 


61 


> 




<» 


62 


? 




<?> 


63 


OJ 


(at sign) 


<a> 


64 


A 




<A> 


65 


B 




<B> 


66 


C 




<c> 


67 


D 




<D> 


68 


E 




<E> 


69 


F 




<F> 


70 


G 




<G> 


71 


LI 

H 




<n> 


7Z 


I 




<I> 


73 


J 




<J> 


74 


K 




<K> 


75 


L 




<L> 


76 


M 




<M> 


77 


N 




<N> 


78 


0 




<0> 


79 


P 




<P> 


80 


Q 




<Q> 


81 


R 




<R> 


82 


S 




<S> 


83 


T 




<T> 


84 


U 




<U> 


85 


V 




<V> 


86 


w 




<W> 


87 
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Table F-1. The ASCII 


Character Set (cont) 


A Cr T T M AMC 


PLIADArTCD CMTDv 
LnAKML 1 tn tiMIKY 


DECIMAL CODE 


X 


<x> 




Y 


<Y> 


89 


Z 


<Z> 


90 


[ (Left bracket) 


<[> 


91 


\ (backslash) 


<\> 


92 


] (right bracket) 


<]> 


93 


^ (circumflex) 


<'^> 


94 


— 




95 




<•> 




a 


<a> 


97 


b 


<b> 


98 


c 


<c> 


99 


d 


<d> 


100 


e 


<e> 


101 


f 


<f> 


102 


g 


<g> 


103 


h 


<h> 


1 UH 


i 


<i> 


105 


i 


<i> 


106 


k 


<k> 


107 


L 


<L> 


108 


m 


<m> 


109 


n 


<n> 


110 


0 


<o> 


111 


P 


<P> 


112 


q 


<q> 


113 


r 


<r> 


114 


s 


<s> 


115 


t 


<t> 


116 


u 


<u> 


117 


V 


<v> 


118 


w 


<w> 


119 
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Table F-1. The ASCII 


Character Set (cont) 


ASCII NAME 


CHARACTER ENTRY 


DECIMAL CODE 


X 


<x> 


120 


y 


<y> 


121 


2 


<z> 


122 


{ (Left brace) 


<{> 


123 


1 (or bar) 


<l> 


124 


} (right brace) 


<}> 


125 


~ (tiLde) 


<~> 


126 


DEL 


<DEL> 


127 
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